Struct dbus::blocking::Connection

pub struct Connection { /* fields omitted */ }

A connection to D-Bus, thread local + non-async version

Methods

impl Connection

pub fn new_session() -> Result<Self, Error>

Create a new connection to the session bus.

pub fn new_system() -> Result<Self, Error>

Create a new connection to the system-wide bus.

pub fn unique_name(&self) -> BusName

Get the connection's unique name.

It's usually something like ":1.54"

pub fn process(&mut self, timeout: Duration) -> Result<bool, Error>

Tries to handle an incoming message if there is one. If there isn't one, it will wait up to timeout

pub fn with_proxy<'a, 'b, D: Into<BusName<'a>>, P: Into<Path<'a>>>(
    &'b self,
    dest: D,
    path: P,
    timeout: Duration
) -> Proxy<'a, &'b Connection>

Create a convenience struct for easier calling of many methods on the same destination and path.

pub fn request_name<'a, N: Into<BusName<'a>>>(
    &self,
    name: N,
    allow_replacement: bool,
    replace_existing: bool,
    do_not_queue: bool
) -> Result<RequestNameReply, Error>

Request a name on the D-Bus.

For detailed information on the flags and return values, see the libdbus documentation.

pub fn release_name<'a, N: Into<BusName<'a>>>(
    &self,
    name: N
) -> Result<ReleaseNameReply, Error>

Release a previously requested name on the D-Bus.

Trait Implementations

impl Sender for Connection

fn send(&self, msg: Message) -> Result<u32, ()>

Schedules a message for sending.

impl MatchingReceiver for Connection

type F = Box<dyn FnMut(Message, &Connection) -> bool>

Type of callback

fn start_receive(&self, m: MatchRule<'static>, f: Self::F) -> u32

Add a callback to be called in case a message matches.

fn stop_receive(&self, id: u32) -> Option<(MatchRule<'static>, Self::F)>

Remove a previously added callback.

impl BlockingSender for Connection

fn send_with_reply_and_block(
    &self,
    msg: Message,
    timeout: Duration
) -> Result<Message, Error>

Sends a message over the D-Bus and blocks, waiting for a reply or a timeout. This is used for method calls.