'\" te
.TH dbus-monitor 1 "25 Feb 2009" "SunOS 5.11" "User Commands"
.SH "NAME"
dbus-monitor \- debug probe to print message bus messages
.SH "SYNOPSIS"
.PP
\fBdbus-monitor\fR [-\fB-system\fR | -\fB-session\fR] [-\fB-profile\fR | -\fB-monitor\fR] [\fBwatch_expressions\fR]
.SH "DESCRIPTION"
.PP
The \fBdbus-monitor\fR command is used to monitor messages going through
a D\-Bus message bus\&.
.PP
There are two standard message buses:
.sp
.in +2
\(bu
.mk
.in +3
.rt
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\&.
.sp
.in -3
\(bu
.mk
.in +3
.rt
per-user-login-session message bus - Launched each time a user logs in\&.
.sp
.in -3
.in -2
.PP
The -\fB-system\fR and -\fB-session\fR options direct
\fBdbus-monitor\fR to monitor the system or session buses respectively\&.
If neither is specified, \fBdbus-monitor\fR monitors the session bus\&.
.PP
\fBdbus-monitor\fR has two different output modes, the \&'classic\&'-style
monitoring mode and profiling mode\&. The profiling format is a compact format
with a single line per message and microsecond-resolution timing information\&.
The -\fB-profile\fR and -\fB-monitor\fR options select the
profiling and monitoring output format respectively\&.  If neither is specified,
\fBdbus-monitor\fR uses the monitoring output format\&.
.PP
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\&.
.PP
The message bus configuration may keep \fBdbus-monitor\fR from seeing all
messages, especially if you run the monitor as a non-root user\&.
.SH "OPTIONS"
.PP
The following options are supported:
.sp
.ne 2
.mk
\fB-\fB-monitor\fR\fR
.sp .6
.in +4
Use the monitoring output format (this is the default)\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fB-profile\fR\fR
.sp .6
.in +4
Use the profiling output format\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fB-session\fR\fR
.sp .6
.in +4
Monitor the session message bus (this is the default)\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fB-system\fR\fR
.sp .6
.in +4
Monitor the system message bus\&.  The system bus is disabled and unsupported
on Solaris\&.
.sp
.sp 1
.in -4
.SH "OPERANDS"
.PP
The following operands are supported:
.sp
.ne 2
.mk
\fB\fB\fIwatch_expressions\fR\fR\fR
.in +24n
.rt
In order to display the messages you are interested in, you should specify
a set of \fIwatch_expressions\fR as you would expect
to be passed to the dbus_bus_add_watch function\&.
.sp
.sp 1
.in -24n
.SH "EXAMPLES"
.PP
\fBExample 1: How to use \fBdbus-monitor\fR to watch for the GNOME
typing monitor to say things\fR
.PP
.PP
.nf
example% \fBdbus-monitor "type=\&'signal\&',sender=\&'org\&.gnome\&.TypingMonitor\&',interface=\&'org\&.gnome\&.TypingMonitor\&'"\fR
.fi
.SH "EXIT STATUS"
.PP
The following exit values are returned:
.sp
.ne 2
.mk
\fB\fB0\fR\fR
.in +9n
.rt
Application exited successfully
.sp
.sp 1
.in -9n
.sp
.ne 2
.mk
\fB\fB>0\fR\fR
.in +9n
.rt
Application exited with failure
.sp
.sp 1
.in -9n
.SH "FILES"
.PP
The following files are used by this application:
.sp
.ne 2
.mk
\fB\fB/usr/bin/dbus-monitor\fR\fR
.in +32n
.rt
Executable for \fBdbus-monitor\fR
.sp
.sp 1
.in -32n
.SH "ATTRIBUTES"
.PP
See
\fBattributes\fR(5)
for descriptions of the following attributes:
.sp
.TS
tab() allbox;
cw(2.750000i)| cw(2.750000i)
lw(2.750000i)| lw(2.750000i).
ATTRIBUTE TYPEATTRIBUTE VALUE
Availabilitysystem/library/dbus
Interface stabilityVolatile
.TE
.sp
.SH "SEE ALSO"
.PP
More information can be found at:
.PP
\fBhttp://www\&.freedesktop\&.org/software/dbus/\fR
.PP
\fBdbus-binding-tool\fR(1),
\fBdbus-cleanup-sockets\fR(1),
\fBdbus-daemon\fR(1),
\fBdbus-launch\fR(1),
\fBdbus-send\fR(1),
\fBdbus-uuidgen\fR(1),
\fBlibdbus-glib-1\fR(3),
\fBattributes\fR(5)
.SH "NOTES"
.PP
For authorship information refer to
\fBhttp://www\&.freedesktop\&.org/software/dbus/doc/AUTHORS\fR\&.
Updated by Brian Cameron, Sun Microsystems Inc\&., 2007\&.
.PP
\fBdbus-monitor\fR was written by Philip Blundell\&.  The profiling output
mode was added by Olli Salli\&.
.PP
Please send bug reports to the D\-Bus mailing list or bug
tracker, see
\fBhttp://www\&.freedesktop\&.org/software/dbus/\fR
...\" created by instant / solbook-to-man, Thu 20 Mar 2014, 02:30
...\" LSARC 2006/368 D-BUS Message Bus System