1dbus-monitor(1) General Commands Manual dbus-monitor(1)
2
3
4
6 dbus-monitor - debug probe to print message bus messages
7
9 dbus-monitor [--system | --session] [--profile | --monitor] [watch
10 expressions]
11
12
14 The dbus-monitor command is used to monitor messages going through a D-
15 Bus message bus. See http://www.freedesktop.org/software/dbus/ for
16 more information about the big picture.
17
18
19 There are two well-known message buses: the systemwide message bus
20 (installed on many systems as the "messagebus" service) and the per-
21 user-login-session message bus (started each time a user logs in). The
22 --system and --session options direct dbus-monitor to monitor the sys‐
23 tem or session buses respectively. If neither is specified, dbus-moni‐
24 tor monitors the session bus.
25
26
27 dbus-monitor has two different output modes, the 'classic'-style moni‐
28 toring mode and profiling mode. The profiling format is a compact for‐
29 mat with a single line per message and microsecond-resolution timing
30 information. The --profile and --monitor options select the profiling
31 and monitoring output format respectively. If neither is specified,
32 dbus-monitor uses the monitoring output format.
33
34
35 In order to get dbus-monitor to see the messages you are interested in,
36 you should specify a set of watch expressions as you would expect to be
37 passed to the dbus_bus_add_watch function.
38
39
40 The message bus configuration may keep dbus-monitor from seeing all
41 messages, especially if you run the monitor as a non-root user.
42
43
45 --system
46 Monitor the system message bus.
47
48 --session
49 Monitor the session message bus. (This is the default.)
50
51 --profile
52 Use the profiling output format.
53
54 --monitor
55 Use the monitoring output format. (This is the default.)
56
57
59 Here is an example of using dbus-monitor to watch for the gnome typing
60 monitor to say things
61
62 dbus-monitor "type='signal',sender='org.gnome.TypingMonitor',interface='org.gnome.TypingMonitor'"
63
64
65
67 dbus-monitor was written by Philip Blundell. The profiling output mode
68 was added by Olli Salli.
69
70
72 Please send bug reports to the D-Bus mailing list or bug tracker, see
73 http://www.freedesktop.org/software/dbus/
74
75
76
77 dbus-monitor(1)