dbus-run-session (1) Linux Manual Page
dbus-run-session – start a process as a new D-Bus session
Synopsis
- dbus-run-session [–config-file FILENAME] [–dbus-daemon BINARY] [–] PROGRAM [ARGUMENTS…]
- dbus-run-session –help
- dbus-run-session –version
- dbus-run-session –help
Description
dbus-run-sessionOne 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 — bash
or to replace the login shell altogether, by combining dbus-run-session with the exec builtin:
exec dbus-run-session — bash
Another 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 check
or (in automake(1)):
AM_TESTS_ENVIRONMENT = export MY_DEBUG=all;
LOG_COMPILER = dbus-run-session
AM_LOG_FLAGS = —
Options
–config-file=FILENAME, –config-file FILENAME- Pass –config-file=FILENAME to the bus daemon, instead of passing it the –session argument. See dbus-daemon(1).
–dbus-daemon=BINARY, –dbus-daemon BINARY
- Run BINARY as dbus-daemon(1), instead of searching the PATH in the usual way for an executable called dbus-daemon.
–help
- Print usage information and exit.
–version
- Print the version of dbus-run-session and exit.
Exit Status
dbus-run-session exits with the exit status of PROGRAM, 0 if the –help or –version options were used, 127 on an error within dbus-run-session itself, or 128+n if the PROGRAM was killed by signal n.Environment
PATH 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.