From 78e9bb837c258ac0ec7712b3d612cc2f407e731e Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 12 Jun 2024 05:50:42 +0200 Subject: Merging upstream version 256. Signed-off-by: Daniel Baumann --- man/systemd.socket.xml | 81 ++++++++++++++++++++++++++++++-------------------- 1 file changed, 48 insertions(+), 33 deletions(-) (limited to 'man/systemd.socket.xml') diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml index 73c8c5b..a944efa 100644 --- a/man/systemd.socket.xml +++ b/man/systemd.socket.xml @@ -1,6 +1,6 @@ + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> @@ -167,9 +167,9 @@ 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 - systemd.exec5 - and - systemd.kill5. + systemd.exec5, + systemd.kill5 and + systemd.resource-control5. The options specific to the [Socket] section of socket units are the following: @@ -221,7 +221,9 @@ x on a port y address in the AF_VSOCK family. The CID is a unique 32-bit integer identifier in AF_VSOCK analogous to an IP address. Specifying the CID is optional, and may be - set to the empty string. + 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. Note that SOCK_SEQPACKET (i.e. ListenSequentialPacket=) is only available @@ -458,21 +460,18 @@ MaxConnections= - The maximum number of connections to - simultaneously run services instances for, when - is set. If more concurrent - connections are coming in, they will be refused until at least - one existing connection is terminated. This setting has no - effect on sockets configured with - or datagram sockets. Defaults to - 64. + The maximum number of connections to simultaneously run services instances for, when + is set. If more concurrent connections are coming in, they will be refused + until at least one existing connection is terminated. This setting has no effect on sockets configured + with or datagram sockets. Defaults to 64. MaxConnectionsPerSource= - The maximum number of connections for a service per source IP address. - This is very similar to the MaxConnections= directive - above. Disabled by default. + The maximum number of connections for a service per source IP address (in case of + IPv4/IPv6), per source CID (in case of AF_VSOCK), or source UID (in case of + AF_UNIX). This is very similar to the MaxConnections= + directive above. Defaults to 0, i.e. disabled. @@ -919,6 +918,20 @@ + + PassFileDescriptorsToExec= + + Takes a boolean argument. Defaults to off. If enabled, file descriptors created by + the socket unit are passed to ExecStartPost=, ExecStopPre=, and + ExecStopPost= commands from the socket unit. The passed file descriptors can be + accessed with + sd_listen_fds3 as + if the commands were invoked from the associated service units. Note that + ExecStartPre= command cannot access socket file descriptors. + + + + @@ -926,25 +939,27 @@ See Also - - systemd1, - systemctl1, - systemd-system.conf5, - systemd.unit5, - systemd.exec5, - systemd.kill5, - systemd.resource-control5, - systemd.service5, - systemd.directives7, - sd_listen_fds3, - sd_listen_fds_with_names3 - + + systemd1 + systemctl1 + systemd-system.conf5 + systemd.unit5 + systemd.exec5 + systemd.kill5 + systemd.resource-control5 + systemd.service5 + systemd.directives7 + sd_listen_fds3 + sd_listen_fds_with_names3 + For more extensive descriptions see the "systemd for Developers" series: - Socket Activation, - Socket Activation, part II, - Converting inetd Services, - Socket Activated Internet Services and OS Containers. + + Socket Activation + Socket Activation, part II + Converting inetd Services + Socket Activated Internet Services and OS Containers + . -- cgit v1.2.3