Struct dbus::nonblock::SyncConnection

pub struct SyncConnection { /* fields omitted */ }

A connection to D-Bus, Send + Sync + async version

Implementations

impl SyncConnection

pub fn unique_name(&self) -> BusName<'_>

Get the connection's unique name.

It's usually something like ":1.54"

pub async 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 async fn release_name<'a, N: Into<BusName<'a>>>(
    &self,
    name: N
) -> Result<ReleaseNameReply, Error>

Release a previously requested name on the D-Bus.

pub async fn add_match(
    &self,
    match_rule: MatchRule<'static>
) -> Result<MsgMatch, Error>

Adds a new match to the connection, and sets up a callback when this message arrives.

The returned value can be used to remove the match.

pub async fn add_match_no_cb(&self, match_str: &str) -> Result<(), Error>

Adds a new match to the connection, without setting up a callback when this message arrives.

pub async fn remove_match_no_cb(&self, match_str: &str) -> Result<(), Error>

Removes a match from the connection, without removing any callbacks.

pub async fn remove_match(&self, id: Token) -> Result<(), Error>

Removes a previously added match and callback from the connection.

Trait Implementations

impl AsRef<Channel> for SyncConnection

fn as_ref(&self) -> &Channel

Performs the conversion.

impl From<Channel> for SyncConnection

fn from(x: Channel) -> Self

Performs the conversion.

impl MatchingReceiver for SyncConnection

type F = Box<dyn FnMut(Message, &SyncConnection) -> bool + Send + 'static>

Type of callback

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

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

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

Remove a previously added callback.

impl NonblockReply for SyncConnection

type F = Box<dyn FnOnce(Message, &SyncConnection) + Send + 'static>

Callback type

fn send_with_reply(&self, msg: Message, f: Self::F) -> Result<Token, ()>

Sends a message and calls the callback when a reply is received.

fn cancel_reply(&self, id: Token) -> Option<Self::F>

Cancels a pending reply.

fn make_f<G: FnOnce(Message, &Self) + Send + 'static>(g: G) -> Self::F

Internal helper function that creates a callback.

fn timeout_maker(&self) -> Option<TimeoutMakerCb>

Get the internal timeout maker

fn set_timeout_maker(
    &mut self,
    f: Option<TimeoutMakerCb>
) -> Option<TimeoutMakerCb>

Set the internal timeout maker

fn set_waker(&mut self, f: Option<WakerCb>) -> Option<WakerCb>

Set the wakeup call

impl Process for SyncConnection

fn process_one(&self, msg: Message)

Dispatches a message.

fn process_all(&self)

Dispatches all pending messages, without blocking.

impl Sender for SyncConnection

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

Schedules a message for sending.