Struct StatusNode 

pub struct StatusNode {
    pub stable_id: StableId,
    pub display_name: String,
    pub ipv4: IpAddr,
    pub ipv6: IpAddr,
    pub online: Option<bool>,
    pub last_seen: Option<DateTime<Utc>>,
    pub allowed_routes: Vec<IpNet>,
    pub is_exit_node: bool,
    pub cur_addr: Option<SocketAddr>,
    pub relay: Option<String>,
}

A single node entry in a Status snapshot.

Analogous to tsnet’s ipnstate.PeerStatus.

Fields

stable_id: StableId

The node’s stable id (stable across re-registration).

display_name: String

A display name for the node: its fqdn if a tailnet component is known, else its bare hostname.

ipv4: IpAddr

The node’s tailnet IPv4 address.

ipv6: IpAddr

The node’s tailnet IPv6 address.

online: Option<bool>

Whether the node is online, if known (ipnstate.PeerStatus.Online). Tri-state: Some(true) connected to control, Some(false) offline, None unknown (control sent no online status or the local node lacks permission to know). Reflects control’s liveness state, retained from the netmap node + its online deltas — None is unknown, never fabricated to false.

last_seen: Option<DateTime<Utc>>

When control last saw this node online (ipnstate.PeerStatus.LastSeen). Per Go, only meaningful while the node is not currently online. None when unknown or never seen.

allowed_routes: Vec<IpNet>

The routes this node accepts traffic for (its own /32 and /128, plus any advertised subnet routes and possibly the exit-node default route).

is_exit_node: bool

Whether this node advertises a default route (0.0.0.0/0 or ::/0), making it eligible to be selected as an exit node.

cur_addr: Option<SocketAddr>

The current trusted direct UDP endpoint for this peer, if a direct path is confirmed right now (Go ipnstate.PeerStatus.CurAddr). Some ⇒ traffic to this peer flows directly to this address; None ⇒ it relays via DERP (see relay). Mutually exclusive with a relay for a routed peer, mirroring Go’s empty-vs-set CurAddr/Relay strings. A live snapshot — the direct path can expire/re-confirm between calls. Always None for the self node and a whois lookup (no path to oneself; whois is an ownership query).

relay: Option<String>

The DERP region code this peer relays through when there is no direct path (Go ipnstate.PeerStatus.Relay, e.g. "nyc"). Some ⇔ cur_addr is None and the peer’s home DERP region is known; None when a direct path is confirmed, or the region code is unknown. Carries the region code, not its numeric id.

Implementations

impl StatusNode

pub fn from_node(node: &Node) -> StatusNode

Build a StatusNode from a domain Node.

Trait Implementations

impl Clone for StatusNode

fn clone(&self) -> StatusNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StatusNode

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

Formats the value using the given formatter.

impl Eq for StatusNode

impl PartialEq for StatusNode

fn eq(&self, other: &StatusNode) -> 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 StructuralPartialEq for StatusNode