dbus-monitor(1) General Commands Manual dbus-monitor(1)NAME
dbus-monitor - debug probe to print message bus messages
SYNOPSIS
dbus-monitor [--system | --session | --address ADDRESS] [--profile | --monitor] [watch expressions]
DESCRIPTION
The dbus-monitor command is used to monitor messages going through a D-Bus message bus. See http://www.freedesktop.org/software/dbus/ for
more information about the big picture.
There are two well-known message buses: the systemwide message bus (installed on many systems as the "messagebus" service) and the
per-user-login-session message bus (started each time a user logs in). The --system and --session options direct dbus-monitor to monitor
the system or session buses respectively. If neither is specified, dbus-monitor monitors the session bus.
dbus-monitor has two different output modes, the 'classic'-style monitoring mode and profiling mode. The profiling format is a compact for-
mat with a single line per message and microsecond-resolution timing information. The --profile and --monitor options select the profiling
and monitoring output format respectively. If neither is specified, dbus-monitor uses the monitoring output format.
In order to get dbus-monitor to see the messages you are interested in, you should specify a set of watch expressions as you would expect
to be passed to the dbus_bus_add_match function.
The message bus configuration may keep dbus-monitor from seeing all messages, especially if you run the monitor as a non-root user.
OPTIONS --system
Monitor the system message bus.
--session
Monitor the session message bus. (This is the default.)
--address ADDRESS
Monitor an arbitrary message bus given at ADDRESS.
--profile
Use the profiling output format.
--monitor
Use the monitoring output format. (This is the default.)
EXAMPLE
Here is an example of using dbus-monitor to watch for the gnome typing monitor to say things
dbus-monitor "type='signal',sender='org.gnome.TypingMonitor',interface='org.gnome.TypingMonitor'"
AUTHOR
dbus-monitor was written by Philip Blundell. The profiling output mode was added by Olli Salli.
BUGS
Please send bug reports to the D-Bus mailing list or bug tracker, see http://www.freedesktop.org/software/dbus/
dbus-monitor(1)
Check Out this Related Man Page
dbus-send(1) User Commands dbus-send(1)NAME
dbus-send - Send a message to a message bus
SYNOPSIS
dbus-send [--system | --session] [--dest=name] [--help] [--print-reply] [--type=type] destination_object_path message_name [contents...]
DESCRIPTION
The dbus-send command is used to send a message to a D-Bus message bus.
There are two standard message buses:
o systemwide message bus - Disabled and not supported on Solaris, but installed on many systems as the "messagebus" init service.
o per-user-login-session message bus - Enabled and supported on Solaris, and started each time a user logs in.
The --system and --session options direct dbus-send to send messages to the system or session buses respectively. If neither is speci-
fied, dbus-send sends to the session bus.
Nearly all uses of dbus-send must provide the --dest argument which is the name of a connection on the bus to send the message to. If
--dest is omitted, no destination is set.
See http://www.freedesktop.org/software/dbus/ for more information.
OPTIONS
The following options are supported:
--dest=name
Specify the name of the connection to receive the message.
--help
Show help information on standard output and exit.
--print-reply
Block for a reply to the message sent, and print any reply received.
--session
Send to the session message bus (this is the default).
--system
Send to the system message bus. The system bus is disabled and unsupported on Solaris.
--type=type
Specify "method_call" or "signal" (defaults to "signal").
OPERANDS
The following operands are supported:
destination_object_path The object path of the message to send must always be specified.
message_name The name of the message to send must always be specified.
contents Following arguments, if any, are the message contents (message arguments). These are given as a type name, a
colon, and then the value of the argument. The possible type names are: string, int32, uint32, double, byte, bool-
ean. (D-Bus supports more types than these, but dbus-send currently does not.)
EXAMPLES
Example 1: How to use dbus-send with a sh-compatible shell to start the per-session bus daemon
example% dbus-send --dest='org.freedesktop.ExampleName
/org/freedesktop/sample/object/name
org.freedesktop.ExampleInterface.ExampleMethod
int32:47 string:'hello world' double:65.32
Note that the interface is separated from a method or signal name by a dot, though in the actual protocol the interface and the interface
member are separate fields.
EXIT STATUS
The following exit values are returned:
0 Application exited successfully
>0 Application exited with failure
FILES
The following files are used by this application:
/usr/bin/dbus-send Executable for dbus-send
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWdbus |
+-----------------------------+-----------------------------+
|Interface stability |Volatile |
+-----------------------------+-----------------------------+
SEE ALSO dbus-cleanup-sockets(1), dbus-daemon(1), dbus-launch(1), dbus-monitor(1), dbus-uuidgen(1), libdbus-glib-1(3), attributes(5)NOTES
For authorship information refer to http://www.freedesktop.org/software/dbus/doc/AUTHORS. Updated by Brian Cameron, Sun Microsystems Inc.,
2007.
dbus-send was written by Philip Blundell.
Please send bug reports to the D-Bus mailing list or bug tracker, see http://www.freedesktop.org/software/dbus/
SunOS 5.11 19 Nov 2007 dbus-send(1)