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 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 same_relay<'b>(&self, other: &Relay<'b>) -> bool

Return true if this relay and other seem to be the same relay.

(Two relays are the same if they have the same identity.)

source

pub fn supports_exit_port_ipv4(&self, port: u16) -> bool

Return true if this relay allows exiting to port on IPv4.

source

pub fn supports_exit_port_ipv6(&self, port: u16) -> bool

Return true if this relay allows exiting to port on IPv6.

source

pub fn is_dir_cache(&self) -> bool

Return true if this relay is suitable for use as a directory cache.

source

pub fn is_flagged_guard(&self) -> bool

Return true if this relay is marked as usable as a new Guard node.

source

pub fn in_same_subnet<'b>(
 &self,
 other: &Relay<'b>,
 subnet_config: &SubnetConfig
) -> bool

Return true if both relays are in the same subnet, as configured by subnet_config.

Two relays are considered to be in the same subnet if they have IPv4 addresses with the same subnets_family_v4-bit prefix, or if they have IPv6 addresses with the same subnets_family_v6-bit prefix.

source

pub fn in_same_family<'b>(&self, other: &Relay<'b>) -> bool

Return true if both relays are in the same family.

(Every relay is considered to be in the same family as itself.)

source

pub fn policies_allow_some_port(&self) -> bool

Return true if there are any ports for which this Relay can be used for exit traffic.

(Returns false if this relay doesn’t allow exit traffic, or if it has been flagged as a bad exit.)

source

pub fn ipv4_policy(&self) -> Arc<PortPolicy>

Return the IPv4 exit policy for this relay. If the relay has been marked BadExit, return an empty policy

source

pub fn ipv6_policy(&self) -> Arc<PortPolicy>

Return the IPv6 exit policy for this relay. If the relay has been marked BadExit, return an empty policy

source

pub fn ipv4_declared_policy(&self) -> &Arc<PortPolicy>

Return the IPv4 exit policy declared by this relay. Contrary to Relay::ipv4_policy, this does not verify if the relay is marked BadExit.

source

pub fn ipv6_declared_policy(&self) -> &Arc<PortPolicy>

Return the IPv6 exit policy declared by this relay. Contrary to Relay::ipv6_policy, this does not verify if the relay is marked BadExit.

Trait Implementations

source

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

source

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

Return the addresses at which you can connect to this relay

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

fn ed_identity_key(&self) -> Option<PublicKey>

Return the ed25519 identity key for this relay, if it is valid. 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) -> Vec<LinkSpec, Global>

Return a new vector of link specifiers for this relay.

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

Auto Trait Implementations

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,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

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

const: unstable · source

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

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T> Instrument for T

source

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

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

source

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 for T where
U: From<T>,

const: unstable · 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<T> 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 for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

source

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

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

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

fn vzip(self) -> V

source

impl<T> WithSubscriber for T

source

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

source

fn with_current_subscriber(self) -> WithDispatch<Self>

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

Struct tor_netdir::Relay

Implementations

impl<'a> Relay<'a>

pub fn id(&self) -> &Ed25519Identity

pub fn rsa_id(&self) -> &RsaIdentity

pub fn same_relay<'b>(&self, other: &Relay<'b>) -> bool

pub fn supports_exit_port_ipv4(&self, port: u16) -> bool

pub fn supports_exit_port_ipv6(&self, port: u16) -> bool

pub fn is_dir_cache(&self) -> bool

pub fn is_flagged_guard(&self) -> bool

pub fn in_same_subnet<'b>( &self, other: &Relay<'b>, subnet_config: &SubnetConfig) -> bool

pub fn in_same_family<'b>(&self, other: &Relay<'b>) -> bool

pub fn policies_allow_some_port(&self) -> bool

pub fn ipv4_policy(&self) -> Arc<PortPolicy>

pub fn ipv6_policy(&self) -> Arc<PortPolicy>

pub fn ipv4_declared_policy(&self) -> &Arc<PortPolicy>

pub fn ipv6_declared_policy(&self) -> &Arc<PortPolicy>

Trait Implementations

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

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

fn ed_identity(&self) -> &Ed25519Identity

fn rsa_identity(&self) -> &RsaIdentity

fn ed_identity_key(&self) -> Option<PublicKey>

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

fn ntor_onion_key(&self) -> &PublicKey

fn protovers(&self) -> &Protocols

fn linkspecs(&self) -> Vec<LinkSpec, Global>

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

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

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

Auto Trait Implementations

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

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

fn type_id(&self) -> TypeId

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

fn borrow(&self) -> &T

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

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

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> Instrument for T

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

fn in_current_span(self) -> Instrumented<Self>

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

fn into(self) -> U

impl<T> Same<T> for T

type Output = T

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

type Owned = T

fn to_owned(&self) -> T

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

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

type Error = Infallible

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

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

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

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

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>,

fn with_current_subscriber(self) -> WithDispatch<Self>

pub fn in_same_subnet<'b>(
&self,
other: &Relay<'b>,
subnet_config: &SubnetConfig
) -> bool

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

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

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

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

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

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

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

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

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