Index · Directives systemd 250


systemd-stdio-bridge — D-Bus proxy


systemd-stdio-bridge [OPTIONS...]


systemd-stdio-bridge implements a proxy for a D-Bus endpoint. It expects to receive an open connection to a bus when started, and will also connect to a (different) bus as a client. It will then act as a server on the first connection, and forward messages between the two busses. This program is suitable for socket activation: the first connection may be a pipe or a socket and must be passed as either standard input, or as an open file descriptor according to the protocol described in sd_listen_fds(3). The second connection will be made by default to the local system bus, but this can be influenced by the --user, --system, --machine=, and --bus-path= options described below.

sd-bus(3) uses systemd-stdio-bridge to forward D-Bus connections over ssh(1), or to connect to the bus of a different user, see sd_bus_set_address(3).


The following options are understood:


Talk to the service manager of the calling user, rather than the service manager of the system.


Talk to the service manager of the system. This is the implied default.

-M, --machine=

Execute operation on a local container. Specify a container name to connect to, optionally prefixed by a user name to connect as and a separating "@" character. If the special string ".host" is used in place of the container name, a connection to the local system is made (which is useful to connect to a specific user's user bus: "--user"). If the "@" syntax is not used, the connection is made as root user. If the "@" syntax is used either the left hand side or the right hand side may be omitted (but not both) in which case the local user name and ".host" are implied.

-p PATH, --bus-path=PATH

Path to the bus address. Default: "unix:path=/run/dbus/system_bus_socket"

-h, --help

Print a short help text and exit.


Print a short version string and exit.

Exit status

On success, 0 is returned, a non-zero failure code otherwise.

See Also

dbus-daemon(1), dbus-broker(1), D-Bus, systemd(1)