Man page - dbus-run-session(1)

Packages contains this manual

Package: dbus-daemon
apt-get install dbus-daemon

Manuals in package:

Documentations in package:

dbus-daemon

Manual

DBUS-RUN-SESSION

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXIT STATUS
ENVIRONMENT
BUGS
AUTHOR
SEE ALSO

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