Struct WifiScope 

pub struct WifiScope { /* private fields */ }

Operations scoped to a single Wi-Fi interface.

Created via NetworkManager::wifi. Cheap to construct (Clone is fine).

Implementations

impl WifiScope

pub fn interface(&self) -> &str

The interface name this scope is pinned to (e.g. "wlan0").

pub async fn scan(&self) -> Result<()>

Trigger a Wi-Fi scan on this interface only.

pub async fn list_networks(&self) -> Result<Vec<Network>>

List visible networks on this interface (grouped by SSID).

pub async fn list_access_points(&self) -> Result<Vec<AccessPoint>>

List individual access points on this interface (one per BSSID).

pub async fn connect(&self, ssid: &str, creds: WifiSecurity) -> Result<()>

Connect this interface to the given SSID.

pub async fn connect_to_bssid( &self, ssid: &str, bssid: Option<&str>, creds: WifiSecurity, ) -> Result<()>

Connect this interface to a specific BSSID for the given SSID.

pub async fn disconnect(&self) -> Result<()>

Disconnect this interface from its active network, if any.

pub async fn set_enabled(&self, enabled: bool) -> Result<()>

Enable or disable autoconnect on this interface only.

Independent of NetworkManager’s global Wi-Fi killswitch (set_wireless_enabled).

pub async fn forget(&self, ssid: &str) -> Result<()>

Forget a saved Wi-Fi connection by SSID.

Note: NetworkManager keys profiles by SSID, not by interface, so this forgets the profile globally — but is exposed here for ergonomic use alongside the other per-scope operations.

Trait Implementations

impl Clone for WifiScope

fn clone(&self) -> WifiScope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WifiScope

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

Formats the value using the given formatter.