dbus-monitor(1) User Commands dbus-monitor(1)NAMEdbus-monitor - debug probe to print message bus messages
SYNOPSISdbus-monitor [--system | --session] [--profile | --monitor]
[watch_expressions]
DESCRIPTION
The dbus-monitor command is used to monitor messages going through a
D-Bus message bus.
There are two standard message buses:
· systemwide message bus - Launched when the system is started and
is always available. Additional systemwide services can be
launched via D-Bus service activation. However, D-Bus service
activation is disabled on Solaris.
· per-user-login-session message bus - Launched 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 moni‐
toring 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_watch 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
The following options are supported:
--monitor
Use the monitoring output format (this is the default).
--profile
Use the profiling output format.
--session
Monitor the session message bus (this is the default).
--system
Monitor the system message bus. The system bus is disabled and
unsupported on Solaris.
OPERANDS
The following operands are supported:
watch_expressions In order to display the messages you are inter‐
ested in, you should specify a set of
watch_expressions as you would expect to be
passed to the dbus_bus_add_watch function.
EXAMPLES
Example 1: How to use dbus-monitor to watch for the GNOME typing moni‐
tor to say things
example% dbus-monitor "type='signal',sender='org.gnome.TypingMonitor',interface='org.gnome.TypingMonitor'"
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-monitor Executable for dbus-monitorATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │system/library/dbus │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSO
More information can be found at:
http://www.freedesktop.org/software/dbus/
dbus-binding-tool(1), dbus-cleanup-sockets(1), dbus-daemon(1), dbus-
launch(1), dbus-send(1), dbus-uuidgen(1), libdbus-glib-1(3),
attributes(5)NOTES
For authorship information refer to http://www.freedesktop.org/soft‐
ware/dbus/doc/AUTHORS. Updated by Brian Cameron, Sun Microsystems
Inc., 2007.
dbus-monitor was written by Philip Blundell. The profiling output mode
was added by Olli Salli.
Please send bug reports to the D-Bus mailing list or bug tracker, see
http://www.freedesktop.org/software/dbus/
SunOS 5.11 25 Feb 2009 dbus-monitor(1)
