2003-06-21 Philip Blundell <philb@gnu.org>
[platform/upstream/dbus.git] / tools / dbus-monitor.1
1 .\" 
2 .\" dbus-monitor manual page.
3 .\" Copyright (C) 2003 Red Hat, Inc.
4 .\"
5 .TH dbus-monitor 1
6 .SH NAME
7 dbus-monitor \- debug probe to print message bus messages
8 .SH SYNOPSIS
9 .PP
10 .B dbus-monitor
11 [\-\-system | \-\-session]
12
13 .SH DESCRIPTION
14
15 The \fIdbus-monitor\fP command is used to monitor messages going
16 through a D-BUS message bus.  See
17 http://www.freedesktop.org/software/dbus/ for more information about
18 the big picture.
19
20 .PP
21 There are two well-known message buses: the systemwide message bus
22 (installed on many systems as the "messagebus" service) and the
23 per-user-login-session message bus (started each time a user logs in).
24 The \-\-system and \-\-session options direct \fIdbus-monitor\fP to
25 monitor the system or session buses respectively.  If neither is
26 specified, \fIdbus-monitor\fP monitors the session bus.
27
28 .PP 
29 The message bus configuration may keep \fIdbus-monitor\fP from seeing
30 all messages, especially if you run the monitor as a non-root user.
31
32 .SH OPTIONS
33 .TP
34 .I "--system"
35 Monitor the system message bus.
36 .TP
37 .I "--session"
38 Monitor the session message bus.  (This is the default.)
39
40 .SH AUTHOR
41 dbus-monitor was written by Philip Blundell.
42
43 .SH BUGS
44 Please send bug reports to the D-BUS mailing list or bug tracker,
45 see http://www.freedesktop.org/software/dbus/