Struct LocalStack 

pub struct LocalStack { /* private fields */ }

The address families THIS host can originate connections on.

Detection uses the “connect a UDP socket to a documentation address” trick: connecting a UDP socket forces the OS to pick the local source address it would route from WITHOUT sending a packet, so a family with no route (no default route, no address) fails at connect and is recorded as absent. Construct it with LocalStack::detect in production, LocalStack::cached on the hot path, or LocalStack::from_flags deterministically in tests.

Implementations

impl LocalStack

pub fn detect() -> LocalStack

Probe the host’s real IPv6 + IPv4 capability (no packets sent).

pub fn cached() -> LocalStack

The process-wide cached detection, re-probed at most once per [CACHE_TTL].

The dial hot path calls this on every connect; caching keeps the UDP-probe syscalls off it while still refreshing within a bounded window if the host’s stack changes.

pub const fn from_flags(has_v6: bool, has_v4: bool) -> LocalStack

A deterministic stack with the given capabilities — the test constructor for the intersection matrix (no sockets, no host dependency).

pub fn has(&self, family: Family) -> bool

Whether this host can originate a connection on family.

pub fn families(&self) -> Vec<Family>

The families this host has, in preference order (IPv6 before IPv4), present-only.

Trait Implementations

impl Clone for LocalStack

fn clone(&self) -> LocalStack

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for LocalStack

impl Debug for LocalStack

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

Formats the value using the given formatter.

impl Eq for LocalStack

impl PartialEq for LocalStack

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LocalStack