Opens the connection to the DBUS system.
Class DBus
| Raise |
|
| Methods | |
| addMatch | Adds an active filter for incoming signals. |
| dispatch | Perform a dispatch loop on message queues. |
| invoke | Invoke a remote DBUS method. |
| popMessage | Gets the next message waiting to be unqueued. |
| removeMatch | Removes an active filter for incoming signals. |
| signal | Broadcast a message directed to all the potential DBUS listeners. |
| startDispath | Launches the message dispatcher for DBus receivers. |
| stopDispatch | Stops the DBus message dispatcher. |
Adds an active filter for incoming signals.
DBus.addMatch( [rule] )
| rule | The filter rule in DBUS rule specification format. | ||
| Raise |
|
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. | ||
| Raise |
|
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. | ||
| Return | an instance of DBusPendingCall class. | ||
| Raise |
|
Use the returned instance to wait for a reply.
Gets the next message waiting to be unqueued.
DBus.popMessage()
| Return | nil if no message is currently waiting, DBusMessage if a message was waiting. |
If existing the message is extracted from the wait queue and encapsulated in a DBusMessage entity.
Removes an active filter for incoming signals.
DBus.removeMatch( [rule] )
| rule | The filter rule in DBUS rule specification format. | ||
| Raise |
|
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. | ||
| Raise |
|
Launches the message dispatcher for DBus receivers.
DBus.startDispath()
Stops the DBus message dispatcher.
DBus.stopDispatch()