Struct BridgeClient 

pub struct BridgeClient { /* private fields */ }

A live connection to a spawned bridge process, multiplexing D-Bus and stream channels over its stdio.

Implementations

impl BridgeClient

pub fn connect(transport: &dyn Transport) -> Result<BridgeClient>

Spawn the bridge via transport, perform the init handshake, and return a ready client.

pub fn dbus_open(&mut self, name: &str) -> Result<String>

Open an unprivileged D-Bus channel to name and return its channel id.

pub fn dbus_open_privileged(&mut self, name: &str) -> Result<String>

Open a privileged D-Bus channel (superuser: "require"); the bridge performs the sudo/polkit escalation and spawns a root peer (Section 5).

pub fn dbus_call( &mut self, channel: &str, path: &str, iface: &str, method: &str, args: Value, ) -> Result<Value>

Returns the out-argument array (reply[0]). Index [0] for the first return value.

pub fn stream_collect(&mut self, argv: &[&str]) -> Result<Vec<u8>>

Open a stream channel running argv and buffer its output until done.

pub fn stream_each<F: FnMut(&[u8])>( &mut self, argv: &[&str], on_chunk: F, ) -> Result<()>

Open a stream channel and invoke on_chunk for each data frame until done.

pub fn host(&self) -> &str

The host label associated with this connection.

Trait Implementations

impl Drop for BridgeClient

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.