Struct NetworkInterface 

pub struct NetworkInterface {
    pub name: String,
    pub flags: InterfaceFlags,
    pub gateways: Vec<IpAddr>,
    pub addrs: Vec<InterfaceAddress>,
}

A single network interface on this host, with its flags, gateways, and addresses.

Fields

name: String

OS interface name (e.g. en0, eth0).

flags: InterfaceFlags

Interface-level flags.

gateways: Vec<IpAddr>

Default-route gateways reachable through this interface, sorted and deduplicated.

addrs: Vec<InterfaceAddress>

Addresses bound to this interface, sorted by preference and deduplicated.

Implementations

impl NetworkInterface

pub fn new(name: String, flags: InterfaceFlags) -> Self

Make an empty NetworkInterface with the given name and flags.

pub fn name(&self) -> String

OS interface name (e.g. en0, eth0, clat4-rmnet_data0)

pub fn is_loopback(&self) -> bool

Loopback interface (lo/lo0)

pub fn is_point_to_point(&self) -> bool

Point-to-point link (PPP, tun, etc.)

pub fn is_running(&self) -> bool

Interface is up and operational

pub fn is_clat(&self) -> bool

CLAT (RFC 6877) virtual interface (e.g. Android clat4* / v4-*); local-only

pub fn add_address(&mut self, addr: InterfaceAddress)

Append an address to this interface; addresses are kept sorted and deduplicated

pub fn addresses(&self) -> &[InterfaceAddress]

All addresses bound to this interface.

pub fn add_gateway(&mut self, gateway: IpAddr)

Append a gateway to this interface; gateways are kept sorted and deduplicated.

pub fn gateways(&self) -> &[IpAddr]

Default-route gateways reachable through this interface.

pub fn primary_ipv4(&self) -> Option<InterfaceAddress>

Most-preferred IPv4 address on this interface (per InterfaceAddress::cmp).

pub fn primary_ipv6(&self) -> Option<InterfaceAddress>

Most-preferred IPv6 address on this interface (per InterfaceAddress::cmp).

Trait Implementations

impl Clone for NetworkInterface

fn clone(&self) -> NetworkInterface

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NetworkInterface

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NetworkInterface

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for NetworkInterface

impl PartialEq for NetworkInterface

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for NetworkInterface

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for NetworkInterface