dbus-run-session1User CommandsD-Bus@DBUS_VERSION@dbus-run-sessionstart a process as a new D-Bus sessiondbus-run-session--config-file FILENAME--dbus-daemon BINARY-- PROGRAMARGUMENTSdbus-run-session--help dbus-run-session--version DESCRIPTIONdbus-run-session
is used to start a session bus instance of
dbus-daemon
from a shell script, and start a specified program in that session. The
dbus-daemon
will run for as long as the program does, after which it will terminate.One use is to run a shell with its own
dbus-daemon
in a text‐mode or SSH session, and have the
dbus-daemon
terminate automatically on leaving the sub‐shell, like this: dbus-run-session -- bashor to replace the login shell altogether, by combining dbus-run-session
with the exec builtin: exec dbus-run-session -- bashAnother use is to run regression tests and similar things in an isolated
D-Bus session, to avoid either interfering with the "real" D-Bus session
or relying on there already being a D-Bus session active, for instance: dbus-run-session -- make checkor (in
automake1):
AM_TESTS_ENVIRONMENT = export MY_DEBUG=all;
LOG_COMPILER = dbus-run-session
AM_LOG_FLAGS = --
OPTIONSFILENAME, FILENAMEPass
FILENAME
to the bus daemon, instead of passing it the
argument. See
dbus-daemon1.BINARY, BINARYRun BINARY as dbus-daemon1, instead of searching the PATH
in the usual way for an executable called dbus-daemon.Print usage information and exit.Print the version of dbus-run-session and exit.EXIT STATUSdbus-run-session
exits with the exit status of
PROGRAM,
0 if the
or
options were used, 127 on an error within
dbus-run-session
itself, or
128+n
if the
PROGRAM
was killed by signal
n.ENVIRONMENTPATH
is searched to find
PROGRAM,
and (if the --dbus-daemon option is not used or its argument does not
contain a
/ character) to find dbus-daemon.The session bus' address is made available to
PROGRAM
in the environment variable
DBUS_SESSION_BUS_ADDRESS.The variables
DBUS_SESSION_BUS_PID,
DBUS_SESSION_BUS_WINDOWID,
DBUS_STARTER_BUS_TYPE and
DBUS_STARTER_ADDRESS
are removed from the environment, if present.BUGSPlease send bug reports to the D-Bus mailing list or bug tracker,
see http://www.freedesktop.org/software/dbus/SEE ALSOdbus-daemon1,
dbus-launch1