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 --machine=lennart@.host"). 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.
On success, 0 is returned, a non-zero failure code otherwise.
dbus-daemon(1), dbus-broker(1), D-Bus, systemd(1)