X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.socket.xml;h=78d379de92e587a59c7db467bab5cbd2d743289c;hp=e25b5a00fda1096d3081cc86daf74fb8f6428876;hb=59cddb23385b583ae8a9db9d2b10e211ab48495e;hpb=b439c6ee04967fa988d232e0765f972cb27b1877
diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml
index e25b5a00f..78d379de9 100644
--- a/man/systemd.socket.xml
+++ b/man/systemd.socket.xml
@@ -70,7 +70,13 @@
in the [Socket] section.
Additional options are listed in
- systemd.exec5.
+ systemd.exec5,
+ which define the execution environment the
+ ,
+ ,
+ and
+ commands are executed
+ in.
For each socket file a matching service file
(see
@@ -89,6 +95,21 @@
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.
@@ -245,8 +266,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.
@@ -255,7 +278,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.
@@ -413,19 +437,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.
@@ -434,10 +472,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.
@@ -479,13 +518,25 @@
systemd.service5
for details.
+
+
+ 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,