X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.socket.xml;h=3b7581c54512b613e4bbdfd1de1c7f3e264474f5;hb=28cf382a0afd10d0e2a71d152f0df4909e90d159;hp=81f9deab365bf936e11e7f82b8cd63be8553290b;hpb=ba60f9054e7aee0b817cfef4f715b0022818bbb3;p=elogind.git
diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml
index 81f9deab3..3b7581c54 100644
--- a/man/systemd.socket.xml
+++ b/man/systemd.socket.xml
@@ -95,9 +95,35 @@
which services are instantiated for each incoming
connection.
+ Unless DefaultDependencies=
+ is set to , socket units will
+ implicitly have dependencies of type
+ Requires= and
+ After= on
+ sysinit.target as well as
+ dependencies of type Conflicts= and
+ Before= on
+ shutdown.target. These ensure
+ that socket units pull in basic system
+ initialization, and are terminated cleanly prior to
+ system shutdown. Only sockets involved with early
+ boot or late system shutdown should disable this
+ option.
+
Socket units may be used to implement on-demand
starting of services, as well as parallelized starting
of services.
+
+ Note that the daemon software configured for
+ socket activation with socket units needs to be able
+ to accept sockets from systemd, either via systemd's
+ native socket passing interface (see
+ sd_listen_fds3
+ for details) or via the traditional
+ inetd8-style
+ socket passing (i.e. sockets passed in via STDIN and
+ STDOUT, using StandardInput=socket
+ in the service file).
@@ -251,8 +277,10 @@
directories are automatically created
if needed. This option specifies the
file system access mode used when
- creating these directories. Defaults
- to 0755.
+ creating these directories. Takes an
+ access mode in octal
+ notation. Defaults to
+ 0755.
@@ -261,7 +289,8 @@
system socket of FIFO, this option
specifies the file system access mode
used when creating the file
- node. Defaults to
+ node. Takes an access mode in octal
+ notation. Defaults to
0666.
@@ -419,19 +448,33 @@
address. Defaults to .
+
+ TCPCongestion=
+ Takes a string
+ value. Controls the TCP congestion
+ algorithm used by this socket. Should
+ be one of "westwood", "veno", "cubic",
+ "lp" or any other available algorithm
+ supported by the IP stack. This
+ setting applies only to stream
+ sockets.
+
+
ExecStartPre=ExecStartPost=
- Takes a command line,
- which is executed before (resp. after)
- the listening sockets/FIFOs are created and
+ Takes one or more
+ command lines, which are executed
+ before (resp. after) the listening
+ sockets/FIFOs are created and
bound. The first token of the command
line must be an absolute file name,
then followed by arguments for the
- process. If specified more than once,
- all commands are executed one after
- the other, fully serialized. The use of
- these settings is optional.
+ process. Multiple command lines may be
+ specified following the same scheme as
+ used for
+ ExecStartPre= of
+ service unit files.
@@ -440,10 +483,11 @@
Additional commands
that are executed before (resp. after)
the listening sockets/FIFOs are closed
- and removed. If specified more than
- once, all commands are executed one
- after the other, fully serialized. The use of
- these settings is optional.
+ and removed. Multiple command lines
+ may be specified following the same
+ scheme as used for
+ ExecStartPre= of
+ service unit files.
@@ -485,13 +529,44 @@
systemd.service5
for details.
+
+
+ KillSignal=
+ Specifies which signal
+ to use when killing a process of this
+ socket. Defaults to SIGTERM.
+
+
+
+
+ SendSIGKILL=
+ Specifies whether to
+ send SIGKILL to remaining processes
+ after a timeout, if the normal
+ shutdown procedure left processes of
+ the socket around. Takes a boolean
+ value. Defaults to "yes".
+
+
+
+
+ Service=
+ Specifies the service
+ unit name to activate on incoming
+ traffic. This defaults to the service
+ that bears the same name as the socket
+ (ignoring the different suffixes). In
+ most cases it should not be necessary
+ to use this option.
+
+
See Also
- systemd8,
+ systemd1,
systemctl8,
systemd.unit5,
systemd.exec5,