summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-rawhide/man5/systemd.socket.5
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-rawhide/man5/systemd.socket.5')
-rw-r--r--upstream/fedora-rawhide/man5/systemd.socket.554
1 files changed, 33 insertions, 21 deletions
diff --git a/upstream/fedora-rawhide/man5/systemd.socket.5 b/upstream/fedora-rawhide/man5/systemd.socket.5
index 1cd05d5c..3112c60a 100644
--- a/upstream/fedora-rawhide/man5/systemd.socket.5
+++ b/upstream/fedora-rawhide/man5/systemd.socket.5
@@ -1,5 +1,5 @@
'\" t
-.TH "SYSTEMD\&.SOCKET" "5" "" "systemd 255" "systemd.socket"
+.TH "SYSTEMD\&.SOCKET" "5" "" "systemd 256~rc3" "systemd.socket"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -191,9 +191,10 @@ Socket unit files may include [Unit] and [Install] sections, which are described
\fBsystemd.unit\fR(5)\&.
.PP
Socket unit files must include a [Socket] section, which carries information about the socket or FIFO it supervises\&. A number of options that may be used in this section are shared with other unit types\&. These options are documented in
-\fBsystemd.exec\fR(5)
+\fBsystemd.exec\fR(5),
+\fBsystemd.kill\fR(5)
and
-\fBsystemd.kill\fR(5)\&. The options specific to the [Socket] section of socket units are the following:
+\fBsystemd.resource-control\fR(5)\&. The options specific to the [Socket] section of socket units are the following:
.PP
\fIListenStream=\fR, \fIListenDatagram=\fR, \fIListenSequentialPacket=\fR
.RS 4
@@ -243,6 +244,13 @@ address in the
family\&. The CID is a unique 32\-bit integer identifier in
\fBAF_VSOCK\fR
analogous to an IP address\&. Specifying the CID is optional, and may be set to the empty string\&.
+"vsock"
+may be replaced with
+"vsock\-stream",
+"vsock\-dgram"
+or
+"vsock\-seqpacket"
+to force usage of the corresponding socket type\&.
.sp
Note that
\fBSOCK_SEQPACKET\fR
@@ -453,9 +461,11 @@ or datagram sockets\&. Defaults to 64\&.
.PP
\fIMaxConnectionsPerSource=\fR
.RS 4
-The maximum number of connections for a service per source IP address\&. This is very similar to the
+The maximum number of connections for a service per source IP address (in case of IPv4/IPv6), per source CID (in case of
+\fBAF_VSOCK\fR), or source UID (in case of
+\fBAF_UNIX\fR)\&. This is very similar to the
\fIMaxConnections=\fR
-directive above\&. Disabled by default\&.
+directive above\&. Defaults to 0, i\&.e\&. disabled\&.
.sp
Added in version 232\&.
.RE
@@ -727,7 +737,7 @@ Added in version 247\&.
.RS 4
Takes a string value\&. Controls the TCP congestion algorithm used by this socket\&. Should be one of
"westwood",
-"veno",
+"reno",
"cubic",
"lp"
or any other available algorithm supported by the IP stack\&. This setting applies only to stream sockets\&.
@@ -853,6 +863,21 @@ These setting defaults to 150 (in case of
Added in version 255\&.
.RE
.PP
+\fIPassFileDescriptorsToExec=\fR
+.RS 4
+Takes a boolean argument\&. Defaults to off\&. If enabled, file descriptors created by the socket unit are passed to
+\fIExecStartPost=\fR,
+\fIExecStopPre=\fR, and
+\fIExecStopPost=\fR
+commands from the socket unit\&. The passed file descriptors can be accessed with
+\fBsd_listen_fds\fR(3)
+as if the commands were invoked from the associated service units\&. Note that
+\fIExecStartPre=\fR
+command cannot access socket file descriptors\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
Check
\fBsystemd.unit\fR(5),
\fBsystemd.exec\fR(5), and
@@ -860,23 +885,10 @@ Check
for more settings\&.
.SH "SEE ALSO"
.PP
-\fBsystemd\fR(1),
-\fBsystemctl\fR(1),
-\fBsystemd-system.conf\fR(5),
-\fBsystemd.unit\fR(5),
-\fBsystemd.exec\fR(5),
-\fBsystemd.kill\fR(5),
-\fBsystemd.resource-control\fR(5),
-\fBsystemd.service\fR(5),
-\fBsystemd.directives\fR(7),
-\fBsd_listen_fds\fR(3),
-\fBsd_listen_fds_with_names\fR(3)
+\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.unit\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.kill\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.service\fR(5), \fBsystemd.directives\fR(7), \fBsd_listen_fds\fR(3), \fBsd_listen_fds_with_names\fR(3)
.PP
For more extensive descriptions see the "systemd for Developers" series:
-\m[blue]\fBSocket Activation\fR\m[]\&\s-2\u[4]\d\s+2,
-\m[blue]\fBSocket Activation, part II\fR\m[]\&\s-2\u[5]\d\s+2,
-\m[blue]\fBConverting inetd Services\fR\m[]\&\s-2\u[6]\d\s+2,
-\m[blue]\fBSocket Activated Internet Services and OS Containers\fR\m[]\&\s-2\u[7]\d\s+2\&.
+\m[blue]\fBSocket Activation\fR\m[]\&\s-2\u[4]\d\s+2, \m[blue]\fBSocket Activation, part II\fR\m[]\&\s-2\u[5]\d\s+2, \m[blue]\fBConverting inetd Services\fR\m[]\&\s-2\u[6]\d\s+2, \m[blue]\fBSocket Activated Internet Services and OS Containers\fR\m[]\&\s-2\u[7]\d\s+2\&.
.SH "NOTES"
.IP " 1." 4
USB FunctionFS