Struct tor_netdir::Relay

source ·
pub struct Relay<'a> { /* private fields */ }
Expand description

A view of a relay on the Tor network, suitable for building circuits.

Implementations§

source§

impl<'a> Relay<'a>

source

pub fn low_level_details(&self) -> RelayDetails<'_>

Return a RelayDetails for this relay.

Callers should generally avoid using this information directly if they can; it’s better to use a higher-level function that exposes semantic information rather than these properties.

source

pub fn id(&self) -> &Ed25519Identity

Return the Ed25519 ID for this relay.

source

pub fn rsa_id(&self) -> &RsaIdentity

Return the RsaIdentity for this relay.

source

pub fn rs(&self) -> &MdConsensusRouterStatus

Available on crate feature experimental-api only.

Return a reference to this relay’s “router status” entry in the consensus.

The router status entry contains information about the relay that the authorities voted on directly. For most use cases, you shouldn’t need them.

This function is only available if the crate was built with its experimental-api feature.

source

pub fn md(&self) -> &Microdesc

Available on crate feature experimental-api only.

Return a reference to this relay’s “microdescriptor” entry in the consensus.

A “microdescriptor” is a synopsis of the information about a relay, used to determine its capabilities and route traffic through it. For most use cases, you shouldn’t need it.

This function is only available if the crate was built with its experimental-api feature.

Trait Implementations§

source§

impl<'a> ChanTarget for Relay<'a>

source§

fn display_chan_target(&self) -> DisplayChanTarget<'_, Self>
where Self: Sized,

Return a reference to this object suitable for formatting its ChanTarget-specific members. Read more
source§

impl<'a> CircTarget for Relay<'a>

source§

fn ntor_onion_key(&self) -> &PublicKey

Return the ntor onion key for this relay
source§

fn protovers(&self) -> &Protocols

Return the subprotocols implemented by this relay.
source§

fn linkspecs(&self) -> Result<Vec<EncodedLinkSpec>, EncodeError>

Return a new vector of encoded link specifiers for this relay. Read more
source§

impl<'a> Clone for Relay<'a>

source§

fn clone(&self) -> Relay<'a>

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl<'a> HasAddrs for Relay<'a>

source§

fn addrs(&self) -> &[SocketAddr]

Return the addresses listed for this server. Read more
source§

impl<'a> HasCountryCode for Relay<'a>

Available on crate feature geoip only.
source§

fn country_code(&self) -> Option<CountryCode>

Return the country code in which this server is most likely located. Read more
source§

impl<'a> HasRelayIdsLegacy for Relay<'a>

source§

fn ed_identity(&self) -> &Ed25519Identity

Return the ed25519 identity for this relay.
source§

fn rsa_identity(&self) -> &RsaIdentity

Return the RSA identity for this relay.
source§

impl<'a> DirectChanMethodsHelper for Relay<'a>

Auto Trait Implementations§

§

impl<'a> Freeze for Relay<'a>

§

impl<'a> RefUnwindSafe for Relay<'a>

§

impl<'a> Send for Relay<'a>

§

impl<'a> Sync for Relay<'a>

§

impl<'a> Unpin for Relay<'a>

§

impl<'a> UnwindSafe for Relay<'a>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<D> HasChanMethod for D

source§

fn chan_method(&self) -> ChannelMethod

Return the known ways to contact this
source§

impl<T> HasRelayIds for T

source§

fn identity(&self, key_type: RelayIdType) -> Option<RelayIdRef<'_>>

Return the identity of this relay whose type is key_type, or None if the relay has no such identity. Read more
source§

fn identities(&self) -> RelayIdIter<'_, Self>

Return an iterator over all of the identities held by this object.
source§

fn ed_identity(&self) -> Option<&Ed25519Identity>

Return the ed25519 identity for this relay if it has one.
source§

fn rsa_identity(&self) -> Option<&RsaIdentity>

Return the RSA identity for this relay if it has one.
source§

fn has_identity(&self, id: RelayIdRef<'_>) -> bool

Check whether the provided Id is a known identity of this relay. Read more
source§

fn has_any_identity(&self) -> bool

Return true if this object has any known identity.
source§

fn same_relay_ids<T>(&self, other: &T) -> bool
where T: HasRelayIds + ?Sized,

Return true if this object has exactly the same relay IDs as other.
source§

fn has_all_relay_ids_from<T>(&self, other: &T) -> bool
where T: HasRelayIds + ?Sized,

Return true if this object has every relay ID that other does. Read more
source§

fn has_any_relay_id_from<T>(&self, other: &T) -> bool
where T: HasRelayIds + ?Sized,

Return true if this object has any relay ID that other has. Read more
source§

fn cmp_by_relay_ids<T>(&self, other: &T) -> Ordering
where T: HasRelayIds + ?Sized,

Compare this object to another HasRelayIds. Read more
source§

fn display_relay_ids(&self) -> DisplayRelayIds<'_, Self>

Return a reference to this object suitable for formatting its HasRelayIds members.
§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more