diff options
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/systemd-socket-activate.1')
| -rw-r--r-- | upstream/opensuse-leap-15-6/man1/systemd-socket-activate.1 | 158 |
1 files changed, 158 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/systemd-socket-activate.1 b/upstream/opensuse-leap-15-6/man1/systemd-socket-activate.1 new file mode 100644 index 00000000..db89b884 --- /dev/null +++ b/upstream/opensuse-leap-15-6/man1/systemd-socket-activate.1 @@ -0,0 +1,158 @@ +'\" t +.TH "SYSTEMD\-SOCKET\-ACTIVATE" "1" "" "systemd 254" "systemd-socket-activate" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +systemd-socket-activate \- Test socket activation of daemons +.SH "SYNOPSIS" +.HP \w'\fBsystemd\-socket\-activate\fR\ 'u +\fBsystemd\-socket\-activate\fR [OPTIONS...] \fIdaemon\fR [OPTIONS...] +.SH "DESCRIPTION" +.PP +\fBsystemd\-socket\-activate\fR +may be used to launch a socket\-activated service program from the command line for testing purposes\&. It may also be used to launch individual instances of the service program per connection\&. +.PP +The daemon to launch and its options should be specified after options intended for +\fBsystemd\-socket\-activate\fR\&. +.PP +If the +\fB\-\-inetd\fR +option is given, the socket file descriptor will be used as the standard input and output of the launched process\&. Otherwise, standard input and output will be inherited, and sockets will be passed through file descriptors 3 and higher\&. Sockets passed through +\fI$LISTEN_FDS\fR +to +\fBsystemd\-socket\-activate\fR +will be passed through to the daemon, in the original positions\&. Other sockets specified with +\fB\-\-listen=\fR +will use consecutive descriptors\&. By default, +\fBsystemd\-socket\-activate\fR +listens on a stream socket, use +\fB\-\-datagram\fR +and +\fB\-\-seqpacket\fR +to listen on datagram or sequential packet sockets instead (see below)\&. +.SH "OPTIONS" +.PP +\fB\-l \fR\fB\fIaddress\fR\fR, \fB\-\-listen=\fR\fB\fIaddress\fR\fR +.RS 4 +Listen on this +\fIaddress\fR\&. Takes a string like +"2000" +or +"127\&.0\&.0\&.1:2001"\&. +.RE +.PP +\fB\-a\fR, \fB\-\-accept\fR +.RS 4 +Launch an instance of the service program for each connection and pass the connection socket\&. +.RE +.PP +\fB\-d\fR, \fB\-\-datagram\fR +.RS 4 +Listen on a datagram socket (\fBSOCK_DGRAM\fR), instead of a stream socket (\fBSOCK_STREAM\fR)\&. May not be combined with +\fB\-\-seqpacket\fR\&. +.RE +.PP +\fB\-\-seqpacket\fR +.RS 4 +Listen on a sequential packet socket (\fBSOCK_SEQPACKET\fR), instead of a stream socket (\fBSOCK_STREAM\fR)\&. May not be combined with +\fB\-\-datagram\fR\&. +.RE +.PP +\fB\-\-inetd\fR +.RS 4 +Use the inetd protocol for passing file descriptors, i\&.e\&. as standard input and standard output, instead of the new\-style protocol for passing file descriptors using +\fI$LISTEN_FDS\fR +(see above)\&. +.RE +.PP +\fB\-E \fR\fB\fIVAR\fR\fR\fB[=\fIVALUE\fR]\fR, \fB\-\-setenv=\fR\fB\fIVAR\fR\fR\fB[=\fIVALUE\fR]\fR +.RS 4 +Add this variable to the environment of the launched process\&. If +\fIVAR\fR +is followed by +"=", assume that it is a variable\(envalue pair\&. Otherwise, obtain the value from the environment of +\fBsystemd\-socket\-activate\fR +itself\&. +.RE +.PP +\fB\-\-fdname=\fR\fINAME\fR[:\fINAME\fR\&...] +.RS 4 +Specify names for the file descriptors passed\&. This is equivalent to setting +\fIFileDescriptorName=\fR +in socket unit files, and enables use of +\fBsd_listen_fds_with_names\fR(3)\&. Multiple entries may be specifies using separate options or by separating names with colons (":") in one option\&. In case more names are given than descriptors, superfluous ones will be ignored\&. In case less names are given than descriptors, the remaining file descriptors will be unnamed\&. +.RE +.PP +\fB\-h\fR, \fB\-\-help\fR +.RS 4 +Print a short help text and exit\&. +.RE +.PP +\fB\-\-version\fR +.RS 4 +Print a short version string and exit\&. +.RE +.SH "ENVIRONMENT VARIABLES" +.PP +\fI$LISTEN_FDS\fR, \fI$LISTEN_PID\fR, \fI$LISTEN_FDNAMES\fR +.RS 4 +See +\fBsd_listen_fds\fR(3)\&. +.RE +.PP +\fI$SYSTEMD_LOG_TARGET\fR, \fI$SYSTEMD_LOG_LEVEL\fR, \fI$SYSTEMD_LOG_TIME\fR, \fI$SYSTEMD_LOG_COLOR\fR, \fI$SYSTEMD_LOG_LOCATION\fR +.RS 4 +Same as in +\fBsystemd\fR(1)\&. +.RE +.SH "EXAMPLES" +.PP +\fBExample\ \&1.\ \&Run an echo server on port 2000\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ systemd\-socket\-activate \-l 2000 \-\-inetd \-a cat +.fi +.if n \{\ +.RE +.\} +.PP +\fBExample\ \&2.\ \&Run a socket\-activated instance of systemd-journal-gatewayd(8)\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ systemd\-socket\-activate \-l 19531 /usr/lib/systemd/systemd\-journal\-gatewayd +.fi +.if n \{\ +.RE +.\} +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), +\fBsystemd.socket\fR(5), +\fBsystemd.service\fR(5), +\fBsystemd-run\fR(1), +\fBsd_listen_fds\fR(3), +\fBsd_listen_fds_with_names\fR(3), +\fBcat\fR(1) |