# DBUS-RUN-SESSION - start a process as a new D-Bus session - man(1) - [phpMan]

[_DBUS-RUN-SESSION_(1)](https://www.chedong.com/phpMan.php/man/DBUS-RUN-SESSION/1/markdown)                         User Commands                        [_DBUS-RUN-SESSION_(1)](https://www.chedong.com/phpMan.php/man/DBUS-RUN-SESSION/1/markdown)

## 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)](https://www.chedong.com/phpMan.php/man/automake/1/markdown)):

             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)](https://www.chedong.com/phpMan.php/man/dbus-daemon/1/markdown).

       **--dbus-daemon=_**BINARY_, **--dbus-daemon _**BINARY_
           Run _BINARY_ as [**dbus-daemon**(1)](https://www.chedong.com/phpMan.php/man/dbus-daemon/1/markdown), 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)](https://www.chedong.com/phpMan.php/man/dbus-daemon/1/markdown), [**dbus-launch**(1)](https://www.chedong.com/phpMan.php/man/dbus-launch/1/markdown)

D-Bus 1.14.10                                                                    [_DBUS-RUN-SESSION_(1)](https://www.chedong.com/phpMan.php/man/DBUS-RUN-SESSION/1/markdown)