Struct Network 

#[non_exhaustive]
pub struct Network {

    pub device: String,
    pub ssid: String,
    pub bssid: Option<String>,
    pub strength: Option<u8>,
    pub frequency: Option<u32>,
    pub secured: bool,
    pub is_psk: bool,
    pub is_eap: bool,
    pub is_hotspot: bool,
    pub ip4_address: Option<String>,
    pub ip6_address: Option<String>,
    pub best_bssid: String,
    pub bssids: Vec<String>,
    pub is_active: bool,
    pub known: bool,
    pub security_features: SecurityFeatures,
}

Represents a Wi-Fi network discovered during a scan.

This struct contains information about a WiFi network that was discovered by NetworkManager during a scan operation.

Examples

use nmrs::NetworkManager;

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

// Scan for networks (None = all Wi-Fi devices)
nm.scan_networks(None).await?;
let networks = nm.list_networks(None).await?;

for net in networks {
    println!("SSID: {}", net.ssid);
    println!("  Signal: {}%", net.strength.unwrap_or(0));
    println!("  Secured: {}", net.secured);
     
    if let Some(freq) = net.frequency {
        let band = if freq > 5000 { "5GHz" } else { "2.4GHz" };
        println!("  Band: {}", band);
    }
}

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.

device: String

Device interface name (e.g., “wlan0”)

ssid: String

Network SSID (name)

bssid: Option<String>

Access point MAC address (BSSID)

strength: Option<u8>

Signal strength (0-100)

frequency: Option<u32>

Frequency in MHz (e.g., 2437 for channel 6)

secured: bool

Whether the network requires authentication

is_psk: bool

Whether the network uses WPA-PSK authentication

is_eap: bool

Whether the network uses WPA-EAP (Enterprise) authentication

is_hotspot: bool

Whether the access point is operating in AP (hotspot) mode

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)

best_bssid: String

BSSID of the strongest AP for this SSID.

bssids: Vec<String>

All known BSSIDs for this SSID, strongest first.

is_active: bool

true if this network is currently active (connected).

known: bool

true if a saved connection profile exists for this SSID.

security_features: SecurityFeatures

Decoded security capabilities from NM flag triplet.

Implementations

impl Network

pub fn merge_ap(&mut self, other: &Network)

Merges another access point’s information into this network.

When multiple access points share the same SSID (e.g., mesh networks), this method keeps the strongest signal and combines security flags. Used internally during network scanning to deduplicate results.

Trait Implementations

impl Clone for Network

fn clone(&self) -> Network

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Network

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Network

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Network

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

where __S: Serializer,

Serialize this value into the given Serde serializer.