11965N/A<!
DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
11965N/A<!--ArborText, Inc., 1988-1999, v.4002-->
11965N/A<!
ENTITY suncopy "Copyright (c) 2007 Sun Microsystems, Inc. All Rights Reserved.">
11965N/A<
refmeta><
refentrytitle>dbus-monitor</
refentrytitle><
manvolnum>1</
manvolnum>
11965N/A<
refmiscinfo class="date">19 Nov 2007</
refmiscinfo>
11965N/A<
refmiscinfo class="sectdesc">&man1;</
refmiscinfo>
11965N/A<
refmiscinfo class="software">&release;</
refmiscinfo>
11965N/A<
refmiscinfo class="arch">generic</
refmiscinfo>
11965N/A<
refmiscinfo class="copyright">&suncopy;</
refmiscinfo>
11965N/A<
indexterm><
primary>dbus-monitor</
primary></
indexterm><
indexterm><
primary>
11965N/Adebug probe to print message bus messages
11965N/A</
primary></
indexterm><
refnamediv id="dbus-monitor-1-name">
11965N/A<
refname>dbus-monitor</
refname><
refpurpose>
11965N/Adebug probe to print message bus messages
11965N/A<
refsynopsisdiv id="dbus-monitor-1-synp"><
title>&synp-tt;</
title>
11965N/A<
cmdsynopsis><
command>&cmd;</
command>
11965N/A<
arg choice="opt"><
option>-system</
option> | <
option>-session</
option></
arg>
11965N/A<
arg choice="opt"><
option>-profile</
option> | <
option>-monitor</
option></
arg>
11965N/A<
arg choice="opt"><
option role="nodash">watch_expressions</
option></
arg>
11965N/A<
refsect1 id="dbus-monitor-1-desc"><
title>&desc-tt;</
title>
11965N/AThe &cmd; command is used to monitor messages going through a D\-Bus message
11965N/AThere are two standard message buses:
11965N/Asystemwide message bus - Disabled and not supported on Solaris, but installed
11965N/Aon many systems as the "messagebus" init service.
11965N/Aper-user-login-session message bus - Enabled and supported on Solaris, and
11965N/Astarted each time a user logs in.
11965N/AThe <
option>-system</
option> and <
option>-session</
option> options direct &cmd;
11965N/Ato monitor the system or session buses respectively. If neither is specified,
11965N/A&cmd; has two different output modes, the 'classic'-style monitoring mode and
11965N/Aprofiling mode. The profiling format is a compact format with a single line
11965N/Aper message and microsecond-resolution timing information. The
11965N/A<
option>-profile</
option> and <
option>-monitor</
option> options select the
11965N/Aprofiling and monitoring output format respectively. If neither is specified,
11965N/A&cmd; uses the monitoring output format.
11965N/AThe message bus configuration may keep &cmd; from seeing all messages,
11965N/Aespecially if you run the monitor as a non-root user.
11965N/A<
refsect1 id="dbus-monitor-1-opts"><
title>&opts-tt;</
title>
11965N/A<
para>The following options are supported:</
para>
11965N/A<
variablelist termlength="wholeline">
11965N/A<
term><
option>-monitor</
option></
term>
11965N/AUse the monitoring output format (this is the default).
11965N/A<
term><
option>-profile</
option></
term>
11965N/AUse the profiling output format.
11965N/A<
term><
option>-session</
option></
term>
11965N/AMonitor the session message bus (this is the default).
11965N/A<
term><
option>-system</
option></
term>
11965N/AMonitor the system message bus. The system bus is disabled and unsupported
11965N/A<
refsect1 id="dbus-monitor-1-oper"><
title>&oper-tt;</
title>
11965N/A<
para>The following operands are supported:</
para>
11965N/A<
variablelist termlength="medium">
11965N/A<
term><
option role="nodash"><
replaceable>watch_expressions</
replaceable></
option></
term>
11965N/AIn order to display the messages you are interested in, you should specify
11965N/Aa set of <
replaceable>watch_expressions</
replaceable> as you would expect
11965N/Ato be passed to the dbus_bus_add_watch function.
11965N/A<
refsect1 id="dbus-monitor-1-exit"><
title>&exit-tt;</
title>
11965N/A<
para>The following exit values are returned:</
para>
11965N/A<
variablelist termlength="xtranarrow">
11965N/A<
term><
returnvalue>0</
returnvalue></
term>
11965N/A<
term><
returnvalue>>0</
returnvalue></
term>
11965N/A<
refsect1 id="dbus-monitor-1-file"><
title>&file-tt;</
title>
11965N/A<
para>The following files are used by this application:</
para>
11965N/A<
variablelist termlength="wide">
11965N/A<
refsect1 id="dbus-monitor-1-attr"><
title>&attr-tt;</
title>
11965N/A<
para>See <
olink targetdocent="REFMAN5" localinfo="attributes-5"><
citerefentry>
11965N/A<
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry></
olink>
11965N/Afor descriptions of the following attributes:</
para>
11965N/A<
tgroup cols="2" colsep="1" rowsep="1"><
colspec colname="COLSPEC0" colwidth="1*">
11965N/A<
colspec colname="COLSPEC1" colwidth="1*">
11965N/A<
row><
entry align="center" valign="middle">ATTRIBUTE TYPE</
entry><
entry align="center" 11965N/Avalign="middle">ATTRIBUTE VALUE</
entry></
row>
11965N/A</
entry></
row><
row><
entry colname="COLSPEC0">
11965N/A<
para>Interface stability</
para>
11965N/A</
entry><
entry colname="COLSPEC1">
11965N/A<
refsect1 id="dbus-monitor-1-also"><
title>&also-tt;</
title>
11965N/A<!--Reference to another man page--> 11965N/A<!--Reference to a Help manual--> 11965N/A<
citerefentry><
refentrytitle>dbus-cleanup-sockets</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
13931N/A<
citerefentry><
refentrytitle>dbus-daemon</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
11965N/A<
citerefentry><
refentrytitle>dbus-launch</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
11965N/A<
citerefentry><
refentrytitle>dbus-send</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
11965N/A<
citerefentry><
refentrytitle>dbus-uuidgen</
refentrytitle><
manvolnum>1</
manvolnum></
citerefentry>,
11965N/A<
citerefentry><
refentrytitle>libdbus-glib-1</
refentrytitle><
manvolnum>3</
manvolnum></
citerefentry>,
11965N/A<
citerefentry><
refentrytitle>attributes</
refentrytitle><
manvolnum>5</
manvolnum></
citerefentry>
11965N/A<
refsect1 id="dbus-monitor-1-note"><
title>¬e-tt;</
title>
11965N/AFor authorship information refer to
11965N/AUpdated by Brian Cameron, Sun Microsystems Inc., 2007.
11965N/A&cmd; was written by Philip Blundell. The profiling output mode was added by
11965N/APlease send bug reports to the D\-Bus mailing list or bug