1 .TH dbus\-run\-session 1
3 dbus\-run\-session \- start a process as a new D-Bus session
11 .IR PROGRAM " [" ARGUMENTS ...]
13 .B dbus\-run\-session \-\-help
15 .B dbus\-run\-session \-\-version
18 is used to start a session bus instance of
20 from a shell script, and start a specified program in that session. The
22 will run for as long as the program does, after which it will terminate.
24 One use is to run a shell with its own
26 in a text\(hymode or SSH session, and have the
28 terminate automatically on leaving the sub\(hyshell, like this:
30 dbus\-run\-session \-\- bash
32 or to replace the login shell altogether, by combining \fBdbus\-run\-session\fR
33 with the \fBexec\fR builtin:
35 exec dbus\-run\-session \-\- bash
37 Another use is to run regression tests and similar things in an isolated
38 D-Bus session, to avoid either interfering with the "real" D-Bus session
39 or relying on there already being a D-Bus session active, for instance:
41 dbus\-run\-session \-\- make check
47 TESTS_ENVIRONMENT = MY_DEBUG=all dbus\-run\-session \-\-
52 \fB\-\-config\-file=\fIFILENAME\fR, \fB\-\-config\-file\fR \fIFILENAME\fR
54 .BI \-\-config-file= FILENAME
55 to the bus daemon, instead of passing it the
60 \fB\-\-dbus\-daemon=\fIBINARY\fR, \fB\-\-dbus\-daemon\fR \fIBINARY\fR
61 Run \fIBINARY\fR as \fBdbus\-daemon\fR(1), instead of searching the \fBPATH\fR
62 in the usual way for an executable called \fBdbus\-daemon\fR.
65 Print usage information and exit.
68 Print the version of dbus\-run\-session and exit.
71 exits with the exit status of
74 .BR \-\-help " or " \-\-version
75 options were used, 127 on an error within
87 and (if the \-\-dbus\-daemon option is not used or its argument does not
89 .BR / " character) to find " dbus\-daemon .
91 The session bus' address is made available to
93 in the environment variable
94 .BR DBUS_SESSION_BUS_ADDRESS .
96 Please send bug reports to the D\-Bus mailing list or bug tracker,
97 see http://www.freedesktop.org/software/dbus/