Struct Interface 

#[non_exhaustive]
pub struct Interface {
    pub id: InterfaceId,
    pub name: String,
    pub interface_type: InterfaceType,
    pub is_up: bool,
    pub addresses: Vec<IpAddr>,
    pub mac: Option<[u8; 6]>,
    pub signal_strength: Option<u8>,
    pub link_speed_mbps: Option<u32>,
    pub is_metered: bool,
}

Network interface descriptor.

Tier: T2-C (Σ + μ + ∃ + ς — typed, mapped, existent, stateful)

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: InterfaceId

Unique interface ID.

name: String

Human-readable name (e.g., “wlan0”, “eth0”).

interface_type: InterfaceType

Interface type.

is_up: bool

Whether the interface is currently up.

addresses: Vec<IpAddr>

Assigned IP addresses.

mac: Option<[u8; 6]>

Hardware (MAC) address, if available.

signal_strength: Option<u8>

Signal strength (0-100), if applicable.

link_speed_mbps: Option<u32>

Link speed in Mbps, if known.

is_metered: bool

Whether this interface is metered.

Implementations

impl Interface

pub fn new( id: impl Into<String>, name: impl Into<String>, interface_type: InterfaceType, ) -> Self

Create a new interface.

pub fn up(self) -> Self

Builder: set the interface as up.

pub fn with_address(self, addr: IpAddr) -> Self

Builder: add an IP address.

pub fn with_mac(self, mac: [u8; 6]) -> Self

Builder: set MAC address.

pub fn with_signal(self, strength: u8) -> Self

Builder: set signal strength.

pub fn with_speed(self, mbps: u32) -> Self

Builder: set link speed.

pub fn has_address(&self) -> bool

Whether this interface has any usable address.

pub fn is_ready(&self) -> bool

Whether this interface is ready for traffic.

pub fn primary_address(&self) -> Option<&IpAddr>

Get the primary (first) address.

pub fn effective_priority(&self) -> u16

Effective routing priority (lower = preferred).

Trait Implementations

impl Clone for Interface

fn clone(&self) -> Interface

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Interface

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Interface

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Interface

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

where __S: Serializer,

Serialize this value into the given Serde serializer.