diff options
| author | Havoc Pennington <hp@redhat.com> | 2003-05-04 03:22:46 +0000 |
|---|---|---|
| committer | Havoc Pennington <hp@redhat.com> | 2003-05-04 03:22:46 +0000 |
| commit | c0158234d046381a6bc8c004c82577576977d0d7 (patch) | |
| tree | dd0c727dc8447837d06338083e7da6994431b667 /tools/dbus-launch.1 | |
| parent | f60d798c5001070718407febeac42b63ddac314f (diff) | |
2003-05-03 Havoc Pennington <hp@pobox.com>
* dbus/dbus-watch.c (dbus_watch_handle): warn and return if a
watch is invalid when handled
* tools/Makefile.am, tools/dbus-launch.c, tools/dbus-launch.1: add
dbus-launch utility to launch the bus from a shell script. Didn't
actually implement dbus-launch yet, it's just a placeholder still.
Diffstat (limited to 'tools/dbus-launch.1')
| -rw-r--r-- | tools/dbus-launch.1 | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/tools/dbus-launch.1 b/tools/dbus-launch.1 new file mode 100644 index 00000000..9342423d --- /dev/null +++ b/tools/dbus-launch.1 @@ -0,0 +1,54 @@ +.\" +.\" dbus-launch manual page. +.\" Copyright (C) 2003 Red Hat, Inc. +.\" +.TH dbus-launch 1 +.SH NAME +dbus-launch \- Utility to start a message bus from a shell script +.SH SYNOPSIS +.PP +.B dbus-launch [\-\-version] [\-\-exit-with-session] + +.SH DESCRIPTION + +The \fIdbus-launch\fP command is used to start \fIdbus-daemon-1\fP +from a shell script. It would normally be called from a user's login +scripts. Unlike the daemon itself, \fIdbus-launch\fP exits, so +backticks or the $() construct can be used to read information from +\fIdbus-launch\fP. \fIdbus-launch\fP prints information about the +launched daemon in KEY=VALUE format. + +.PP +See http://www.freedesktop.org/software/dbus/ for more information +about D-BUS. See also the man page for \fIdbus-daemon-1\fP. + +.PP +Here is an example of how to use \fIdbus-launch\fP with an +sh-compatible shell: +.nf + + VARIABLES=`dbus-launch` + eval $VARIABLES + echo "D-BUS per-session daemon address is: $DBUS_SESSION_BUS_ADDRESS" + +.fi + +.SH OPTIONS +The following options are supported: +.TP +.I "--exit-with-session" +If this option is provided, a persistent "babysitter" process will be +created that watches stdin for HUP and tries to connect to the X +server. If this process gets a HUP on stdin or loses its X connection, +it kills the message bus daemon. + +.TP +.I "--version" +Print the version of dbus-launch + +.SH AUTHOR +See http://www.freedesktop.org/software/dbus/doc/AUTHORS + +.SH BUGS +Please send bug reports to the D-BUS mailing list or bug tracker, +see http://www.freedesktop.org/software/dbus/ |