GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DBUS-RUN-SESSION (1)

.ds Aq ’

NAME

dbus-run-session - start a process as a new D-Bus session

CONTENTS

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 \m[blue]http://www.freedesktop.org/software/dbus/\m[]

SEE ALSO

dbus-daemon(1), dbus-launch(1)

Search for    or go to Top of page |  Section 1 |  Main Index


D-Bus 1&.8&.20 DBUS-RUN-SESSION (1) 03/17/2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.