Debian Codegraph @

upstream/debian-unstable/man1/systemd-stdio-bridge.1

raw
1 '\" t
2 .TH "SYSTEMD\-STDIO\-BRIDGE" "1" "" "systemd 261~rc3" "systemd-stdio-bridge"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-stdio-bridge \- D\-Bus proxy
24 .SH "SYNOPSIS"
25 .HP \w'\fBsystemd\-stdio\-bridge\fR\ 'u
26 \fBsystemd\-stdio\-bridge\fR [OPTIONS...]
27 .SH "DESCRIPTION"
28 .PP
29 \fBsystemd\-stdio\-bridge\fR
30 implements a proxy between STDIN/STDOUT and a D\-Bus bus\&. It expects to receive an open connection via STDIN/STDOUT when started, and will create a new connection to the specified bus\&. It will then forward messages between the two connections\&. 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
31 \fBsd_listen_fds\fR(3)\&. The second connection will be made by default to the local system bus, but this can be influenced by the
32 \fB\-\-user\fR,
33 \fB\-\-system\fR,
34 \fB\-\-machine=\fR, and
35 \fB\-\-bus\-path=\fR
36 options described below\&.
37 .PP
38 \fBsd-bus\fR(3)
39 uses
40 \fBsystemd\-stdio\-bridge\fR
41 to forward D\-Bus connections over
42 \fBssh\fR(1), or to connect to the bus of a different user, see
43 \fBsd_bus_set_address\fR(3)\&.
44 .SH "OPTIONS"
45 .PP
46 The following options are understood:
47 .PP
48 \fB\-\-user\fR
49 .RS 4
50 Talk to the service manager of the calling user, rather than the service manager of the system\&.
51 .RE
52 .PP
53 \fB\-\-system\fR
54 .RS 4
55 Talk to the service manager of the system\&. This is the implied default\&.
56 .RE
57 .PP
58 \fB\-M\fR, \fB\-\-machine=\fR
59 .RS 4
60 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
61 "@"
62 character\&. If the special string
63 "\&.host"
64 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\*(Aqs user bus:
65 "\-\-user \-\-machine=lennart@\&.host")\&. If the
66 "@"
67 syntax is not used, the connection is made as root user\&. If the
68 "@"
69 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
70 "\&.host"
71 are implied\&.
72 .RE
73 .PP
74 \fB\-p \fR\fB\fIPATH\fR\fR, \fB\-\-bus\-path=\fR\fB\fIPATH\fR\fR
75 .RS 4
76 Path to the bus address\&. Default:
77 "unix:path=/run/dbus/system_bus_socket"
78 .sp
79 Added in version 251\&.
80 .RE
81 .PP
82 \fB\-q\fR, \fB\-\-quiet\fR
83 .RS 4
84 Suppresses error logging on failure\&.
85 .sp
86 Added in version 259\&.
87 .RE
88 .PP
89 \fB\-h\fR, \fB\-\-help\fR
90 .RS 4
91 Print a short help text and exit\&.
92 .RE
93 .PP
94 \fB\-\-version\fR
95 .RS 4
96 Print a short version string and exit\&.
97 .RE
98 .SH "EXIT STATUS"
99 .PP
100 On success, 0 is returned, a non\-zero failure code otherwise\&.
101 .SH "SEE ALSO"
102 .PP
103 \fBdbus-daemon\fR(1), \fBdbus-broker\fR(1), \m[blue]\fBD\-Bus\fR\m[]\&\s-2\u[1]\d\s+2, \fBsystemd\fR(1)
104 .SH "NOTES"
105 .IP " 1." 4
106 D-Bus
107 .RS 4
108 \%https://www.freedesktop.org/wiki/Software/dbus
109 .RE