Struct DirectAddrInfo

pub struct DirectAddrInfo {
    pub addr: SocketAddr,
    pub latency: Option<Duration>,
    pub last_control: Option<(Duration, ControlMsg)>,
    pub last_payload: Option<Duration>,
    pub last_alive: Option<Duration>,
    pub sources: HashMap<Source, Duration>,
}

Information about a direct address.

The direct addresses of an iroh-net node are those that could be used by other nodes to establish direct connectivity, depending on the network situation. Due to NAT configurations, for example, not all direct addresses of a node are usable by all peers.

Fields

addr: SocketAddr

The UDP address reported by the remote node.

latency: Option<Duration>

The latency to the remote node over this network path.

If there has never been any connectivity via this address no latency will be known.

last_control: Option<(Duration, ControlMsg)>

Last control message received by this node about this address.

This contains the elapsed duration since the control message was received and the kind of control message received at that time. Only the most recent control message is returned.

Note that ControlMsg::CallMeMaybe is received via a relay path, while ControlMsg::Ping and ControlMsg::Pong are received on the path to DirectAddrInfo::addr itself and thus convey very different information.

last_payload: Option<Duration>

Elapsed time since the last payload message was received on this network path.

This indicates how long ago a QUIC datagram was received from the remote node sent from this DirectAddrInfo::addr. It indicates the network path was in use to transport payload data.

last_alive: Option<Duration>

Elapsed time since this network path was known to exist.

A network path is considered to exist only because the remote node advertised it. It may not mean the path is usable. However, if there was any communication with the remote node over this network path it also means the path exists.

The elapsed time since any confirmation of the path’s existence was received is returned. If the remote node moved networks and no longer has this path, this could be a long duration. If the path was added via Endpoint::add_node_addr or some node discovery the path may never have been known to exist.

sources: HashMap<Source, Duration>

A HashMap of Sources to Durations.

The Duration indicates the elapsed time since this source last recorded this address.

The Duration will always indicate the most recent time the source recorded this address.

Trait Implementations

impl Clone for DirectAddrInfo

fn clone(&self) -> DirectAddrInfo

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DirectAddrInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DirectAddrInfo

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DirectAddrInfo

fn eq(&self, other: &DirectAddrInfo) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for DirectAddrInfo

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for DirectAddrInfo

impl StructuralPartialEq for DirectAddrInfo