man > dbus-run-session(1)

man perldoc info pydoc3 ri search

📖 NAME

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

🚀 Quick Reference

Use Case	Command	Description
💻 Run a shell with its own session bus	dbus-run-session -- bash	Starts a new D-Bus session and runs bash inside it; the daemon terminates when the shell exits.
🧪 Isolate regression tests	dbus-run-session -- make check	Runs tests in an isolated D-Bus session to avoid interfering with the real session.
📄 Show help	dbus-run-session --help	Prints usage information and exits.
🔢 Show version	dbus-run-session --version	Prints the version of dbus-run-session and exits.

📝 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 — 🔍 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.
• DBUS_SESSION_BUS_ADDRESS — 🔗 The session bus' address is made available to PROGRAM in this environment variable.
• DBUS_SESSION_BUS_PID, DBUS_SESSION_BUS_WINDOWID, DBUS_STARTER_BUS_TYPE, DBUS_STARTER_ADDRESS — 🗑️ These variables 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)

📖 NAME 🚀 Quick Reference 📝 SYNOPSIS 📖 DESCRIPTION ⚙️ OPTIONS 🚪 Exit Status 🌍 ENVIRONMENT 🐛 BUGS 📚 SEE ALSO