DBUS-RUN-SESSION man page on Archlinux

Man page or keyword search:  
man Server   11224 pages
apropos Keyword Search (all sections)
Output format
Archlinux logo
[printable version]

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.0			  01/20/2014		   DBUS-RUN-SESSION(1)
[top]

List of man pages available for Archlinux

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net