FreeBSD manual

download PDF document: dbus-run-session.1.pdf

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-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 http://www.freedesktop.org/software/dbus/ SEE ALSO dbus-daemon(1), dbus-launch(1) D-Bus 1.14.10 12/14/2023 DBUS-RUN-SESSION(1)