Manual: dbus-run-session

DBUS-RUN-SESSION(1)					User Commands					 DBUS-RUN-SESSION(1)

NAME
       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

DESCRIPTION
       dbus-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 -- 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.

BUGS
       Please send bug reports to the D-Bus mailing list or bug tracker, see https://www.freedesktop.org/wiki/Software/dbus/

AUTHOR
       See https://dbus.freedesktop.org/doc/AUTHORS

SEE ALSO
       dbus-daemon(1), dbus-launch(1)

D-Bus 1.16.2												 DBUS-RUN-SESSION(1)