Struct Device 

#[non_exhaustive]
pub struct Device {
    pub path: String,
    pub interface: String,
    pub identity: DeviceIdentity,
    pub device_type: DeviceType,
    pub state: DeviceState,
    pub managed: Option<bool>,
    pub driver: Option<String>,
    pub ip4_address: Option<String>,
    pub ip6_address: Option<String>,
    pub frequency: Option<u32>,
    pub speed_mbps: Option<u32>,
}

Represents a network device managed by NetworkManager.

A device can be a WiFi adapter, Ethernet interface, or other network hardware.

Examples

use nmrs::NetworkManager;

let nm = NetworkManager::new().await?;
let devices = nm.list_devices().await?;

for device in devices {
    println!("Interface: {}", device.interface);
    println!("  Type: {}", device.device_type);
    println!("  State: {}", device.state);
    println!("  MAC: {}", device.identity.current_mac);

    if device.is_wireless() {
        println!("  This is a WiFi device");
    } else if device.is_wired() {
        println!("  This is an Ethernet device");
    } else if device.is_bluetooth() {
        println!("  This is a Bluetooth device");
    } else if device.is_loopback() {
        println!("  This is a loopback device");
    }

    if let Some(driver) = &device.driver {
        println!("  Driver: {}", driver);
    }
}

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.

path: String

D-Bus object path

interface: String

Interface name (e.g., “wlan0”, “eth0”)

identity: DeviceIdentity

Device hardware identity (MAC addresses)

device_type: DeviceType

Type of device (WiFi, Ethernet, etc.)

state: DeviceState

Current device state

managed: Option<bool>

Whether NetworkManager manages this device

driver: Option<String>

Kernel driver name

ip4_address: Option<String>

Assigned IPv4 address with CIDR notation (only present when connected)

ip6_address: Option<String>

Assigned IPv6 address with CIDR notation (only present when connected)

frequency: Option<u32>

Operating frequency in MHz for the active Wi-Fi connection, if known.

speed_mbps: Option<u32>

Link speed in megabits per second for Ethernet devices, if known.

This is the raw value reported by NetworkManager. Some drivers report 0 when no carrier is present.

Implementations

impl Device

pub fn is_wired(&self) -> bool

Returns true if this is a wired (Ethernet) device.

pub fn is_wireless(&self) -> bool

Returns true if this is a wireless (Wi-Fi) device.

pub fn is_bluetooth(&self) -> bool

Returns ‘true’ if this is a Bluetooth (DUN or PANU) device.

pub fn is_loopback(&self) -> bool

Returns true if this is a loopback device (e.g., lo).

pub fn is_vlan(&self) -> bool

Returns true if this is a VLAN (802.1Q) device.

Trait Implementations

impl Clone for Device

fn clone(&self) -> Device

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Device

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

Formats the value using the given formatter.

impl Display for Device

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

Formats the value using the given formatter.