| dbus-run-session(1) - phpMan
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)):
TESTS_ENVIRONMENT = MY_DEBUG=all dbus-run-session --
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
http://www.freedesktop.org/software/dbus/
SEE ALSO
dbus-daemon(1), dbus-launch(1)
D-Bus 1.8.22 11/22/2016 DBUS-RUN-SESSION(1)
|