Struct Client 

pub struct Client(/* private fields */);

A connection to wpa_supplicant / hostapd

Implementations

impl Client

pub fn builder() -> ClientBuilder

Creates a builder for a wpa_supplicant / hostapd connection

Examples

let wpa = wpactrl::Client::builder().open().unwrap();

pub fn attach(self) -> Result<ClientAttached>

Register as an event monitor for control interface messages

Examples

let mut wpa = wpactrl::Client::builder().open().unwrap();
let wpa_attached = wpa.attach().unwrap();

Errors

• Error::Attach - Unexpected (non-OK) response
• Error::Io - Low-level I/O error
• Error::Utf8ToStr - Corrupted message or message with non-UTF8 characters
• Error::Wait - Failed to wait on underlying Unix socket

pub fn request(&mut self, cmd: &str) -> Result<String>

Send a command to wpa_supplicant / hostapd.

Commands are generally identical to those used in wpa_cli, except all uppercase (eg LIST_NETWORKS, SCAN, etc)

Examples

let mut wpa = wpactrl::Client::builder().open().unwrap();
assert_eq!(wpa.request("PING").unwrap(), "PONG\n");

Errors

• Error::Io - Low-level I/O error
• Error::Utf8ToStr - Corrupted message or message with non-UTF8 characters
• Error::Wait - Failed to wait on underlying Unix socket