Generic interface to the DBUS system.
class DBus
init | Generic interface to the DBUS system. |
addMatch() | Adds an active filter for incoming signals. |
dispatch() | Perform a dispatch loop on message queues. |
invoke() | Invoke a remote DBUS method. |
removeMatch() | Removes an active filter for incoming signals. |
signal() | Broadcast a message directed to all the potential DBUS listeners. |
Generic interface to the DBUS system.
init DBus
Adds an active filter for incoming signals.
DBus.addMatch( [rule] )
rule | The filter rule in DBUS rule specification format. | ||
Raises: |
|
Set rule to nil or leave empty to perform a "full filter" request.
See the dbus_bus_add_match() description in the official DBUS low level documentation.
Perform a dispatch loop on message queues.
DBus.dispatch( [timeout] )
timeout | An optional timeout to be idle for messages to be sent or receive. | ||
Raises: |
|
Set timeout to zero (or empty) to just dispatch ready messages, or to -1 to wait forever. Otherwise, waits for seconds and fractions.
Invoke a remote DBUS method.
DBus.invoke( destination, path, interface, name, ... )
destination | Well known name of the service provider where the method is searched. | ||
path | Path to the object in the service provider. | ||
interface | Interface in which the method is searched. | ||
name | Method name. | ||
... | Parameters for the method invocation. | ||
Returns: | an instance of DBusPendingCall class. | ||
Raises: |
|
Use the returned instance to wait for a reply.
Removes an active filter for incoming signals.
DBus.removeMatch( [rule] )
rule | The filter rule in DBUS rule specification format. | ||
Raises: |
|
Set rule to nil or leave empty to remove a previous "full filter" request.
See the dbus_bus_remove_match() description in the official DBUS low level documentation.
Broadcast a message directed to all the potential DBUS listeners.
DBus.signal( path, interface, name, ... )
path | the path from the object emitting the signal | ||
interface | the interface the signal is emitted from | ||
name | name of the signal | ||
... | Parameters for the signal. | ||
Raises: |
|