diff options
author | Havoc Pennington <hp@redhat.com> | 2007-02-01 22:41:27 +0000 |
---|---|---|
committer | Havoc Pennington <hp@redhat.com> | 2007-02-01 22:41:27 +0000 |
commit | aa2f74f551b00158baaaf2031a986639f593942b (patch) | |
tree | 2efd6f0c584e17ec7e73e7119d3cf505cc75347e | |
parent | 8d3d8ff55739eebd84d0d53a20a025329feafc3b (diff) |
2007-01-31 Havoc Pennington <hp@redhat.com>
* bus/dbus-daemon.1.in: write a section in the man page on running
a test daemon for debugging purposes
-rw-r--r-- | ChangeLog | 5 | ||||
-rw-r--r-- | bus/dbus-daemon.1.in | 53 |
2 files changed, 58 insertions, 0 deletions
@@ -1,3 +1,8 @@ +2007-01-31 Havoc Pennington <hp@redhat.com> + + * bus/dbus-daemon.1.in: write a section in the man page on running + a test daemon for debugging purposes + 2007-01-26 Havoc Pennington <hp@redhat.com> * bus/session.conf.in: override all the default limits with much diff --git a/bus/dbus-daemon.1.in b/bus/dbus-daemon.1.in index 2298bb75..5c846836 100644 --- a/bus/dbus-daemon.1.in +++ b/bus/dbus-daemon.1.in @@ -597,6 +597,59 @@ If a name has no security context associated in the configuration file, the security context of the bus daemon itself will be used. +.SH DEBUGGING + +.PP +If you're trying to figure out where your messages are going or why +you aren't getting messages, there are several things you can try. + +.PP +Remember that the system bus is heavily locked down and if you +haven't installed a security policy file to allow your message +through, it won't work. For the session bus, this is not a concern. + +.PP +The simplest way to figure out what's happening on the bus is to run +the \fIdbus-monitor\fP program, which comes with the D-Bus +package. You can also send test messages with \fIdbus-send\fP. These +programs have their own man pages. + +.PP +If you want to know what the daemon itself is doing, you might consider +running a separate copy of the daemon to test against. This will allow you +to put the daemon under a debugger, or run it with verbose output, without +messing up your real session and system daemons. + +.PP +To run a separate test copy of the daemon, for example you might open a terminal +and type: +.nf + DBUS_VERBOSE=1 dbus-daemon --session --print-address +.fi + +.PP +The test daemon address will be printed when the daemon starts. You will need +to copy-and-paste this address and use it as the value of the +DBUS_SESSION_BUS_ADDRESS environment variable when you launch the applications +you want to test. This will cause those applications to connect to your +test bus instead of the DBUS_SESSION_BUS_ADDRESS of your real session bus. + +.PP +DBUS_VERBOSE=1 will have NO EFFECT unless your copy of D-Bus +was compiled with verbose mode enabled. This is not recommended in +production builds due to performance impact. You may need to rebuild +D-Bus if your copy was not built with debugging in mind. (DBUS_VERBOSE +also affects the D-Bus library and thus applications using D-Bus; it may +be useful to see verbose output on both the client side and from the daemon.) + +.PP +If you want to get fancy, you can create a custom bus +configuration for your test bus (see the session.conf and system.conf +files that define the two default configurations for example). This +would allow you to specify a different directory for .service files, +for example. + + .SH AUTHOR See http://www.freedesktop.org/software/dbus/doc/AUTHORS |