The internal actions can be traced by running in a debug mode.
Input parameters of
dbus-register-signal are checked for correct D-Bus types. If
there is a type mismatch, the Lisp error
D-Bus ARG is raised.
All errors raised by D-Bus are signaled with the error symbol
dbus-error. If possible, error messages from D-Bus are
appended to the
This executes forms exactly like a
progn, except that
dbus-errorerrors are ignored during the forms. These errors can be made visible when
dbus-debugis set to
Incoming D-Bus messages are handled as Emacs events, see see Misc Events. They are retrieved only, when Emacs runs in interactive mode. The generated event has this form:
(dbus-event bus type serial service path interface member handler &rest args)
bus identifies the D-Bus the message is coming from. It is
either the symbol
:system or the symbol
type is the D-Bus message type which has caused the event. It
serial is the serial number of the received D-Bus message.
service and path are the unique name and the object path of the D-Bus object emitting the message. interface and member denote the message which has been sent.
handler is the callback function which has been registered for
this message (see see Signals). When a
arrives, handler is called with args as arguments.
In order to inspect the
dbus-event data, you could extend the
definition of the callback function in Signals:
(defun my-dbus-signal-handler (&rest args) (message "my-dbus-signal-handler: %S" last-input-event))
There exist convenience functions which could be called inside a callback function in order to retrieve the information from the event.
Returns the bus name event is coming from. The result is either the symbol
:systemor the symbol
Returns the message type of the corresponding D-Bus message. The result is a natural number.
Returns the serial number of the corresponding D-Bus message. The result is a natural number.
Returns the unique name of the D-Bus object event is coming from.
Returns the object path of the D-Bus object event is coming from.
Returns the interface name of the D-Bus object event is coming from.
Returns the member name of the D-Bus object event is coming from. It is either a signal name or a method name.
D-Bus errors are not propagated during event handling, because it is
usually not desired. D-Bus errors in events can be made visible by
setting the variable
t. They can also be
handled by a hook function.
This hook variable keeps a list of functions, which are called when a D-Bus error happens in the event handler. Every function must accept two arguments, the event and the error variable caught in
Such functions can be used the adapt the error signal to be raised. Example:(defun my-dbus-event-error-handler (event error) (when (string-equal (concat dbus-interface-emacs ".FileManager") (dbus-event-interface-name event)) (message "my-dbus-event-error-handler: %S %S" event error) (signal 'file-error (cdr error)))) (add-hook 'dbus-event-error-functions 'my-dbus-event-error-handler)
Hook functions shall take into account, that there might be other D-Bus applications running. Therefore, they shall check carefully, whether a given D-Bus error is related to them.