NAME

Protocol::DBus::Client

SYNOPSIS

my $dbus = Protocol::DBus::Client::system();

$dbus->do_authn();

DESCRIPTION

This is the end class for use in DBus client applications. It subclasses Protocol::DBus::Peer.

NOTE: This module will automatically send a “Hello” message after authentication completes. That message’s response will be processed automatically. Because this is part of the protocol’s handshake logic rather than something useful for callers, it is abstracted away from the caller. It is neither necessary nor productive for callers to send a “Hello” message.

STATIC FUNCTIONS

system()

Creates an instance of this class that includes a connection to the system’s message bus.

This does not do authentication; you’ll need to do that via the class’s methods.

login_session()

Like system() but for the login session’s message bus.

METHODS

$done_yn = OBJ->do_authn()

This returns truthy once the authn is complete and falsy until then. In blocking I/O contexts the call will block until authn is complete.

$yn = OBJ->authn_pending_send()

This indicates whether there is data queued up to send for the authn. Only useful with non-blocking I/O.

$msg = OBJ->get_message()

Same as in the base class, but for clients the initial “Hello” message and its response are abstracted

$name = OBJ->get_connection_name()

Returns the name of the connection. This must only be called after at least one message is received; if it is called before then, an exception is thrown.