X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.socket.xml;h=e15ea602f4b7c322065578b399299c5472c3e73b;hb=65232ea79d8f6b1288c33852f89b575a9200162d;hp=f187fe3bdf97e6319ad689b4b2fbac39518fdbd5;hpb=1f812feafb4b98d5cfa2934886bbdd43325780bb;p=elogind.git
diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml
index f187fe3bd..e15ea602f 100644
--- a/man/systemd.socket.xml
+++ b/man/systemd.socket.xml
@@ -54,10 +54,11 @@
Description
- A unit configuration file whose name ends in .socket
- encodes information about an IPC or network socket or
- a file system FIFO controlled and supervised by systemd,
- for socket-based activation.
+ A unit configuration file whose name ends in
+ .socket encodes information about
+ an IPC or network socket or a file system FIFO
+ controlled and supervised by systemd, for socket-based
+ activation.This man page lists the configuration options
specific to this unit type. See
@@ -65,19 +66,21 @@
for the common options of all unit configuration
files. The common configuration items are configured
in the generic [Unit] and [Install] sections. The
- service specific configuration options are configured
+ socket specific configuration options are configured
in the [Socket] section.Additional options are listed in
systemd.exec5.
- For each socket file a matching service file (see systemd.service5 for details)
- must exist, describing the service to start on
- incoming traffic on the socket. Depending on the
- setting of (see below) this
- must either be named like the socket unit, but with
- the suffix replaced; or it must be a template file
- named the same way. Example: a socket file
+ For each socket file a matching service file
+ (see
+ systemd.service5
+ for details) must exist, describing the service to
+ start on incoming traffic on the socket. Depending on
+ the setting of (see below)
+ this must either be named like the socket unit, but
+ with the suffix replaced; or it must be a template
+ file named the same way. Example: a socket file
foo.socket needs a matching
service foo.service if
is set. If
@@ -85,6 +88,10 @@
file foo@.service must exist from
which services are instantiated for each incoming
connection.
+
+ Socket units may be used to implement on-demand
+ starting of services as well as parallelized starting
+ of services.
@@ -96,7 +103,7 @@
this section are shared with other unit types. These
options are documented in
systemd.exec5. The
- options specific to the [Socket] section of service
+ options specific to the [Socket] section of socket
units are the following:
@@ -406,10 +413,6 @@
address. Defaults to .
-
ExecStartPre=ExecStartPost=
@@ -438,7 +441,6 @@
optional.
-
TimeoutSec=Configures the time to
@@ -454,7 +456,7 @@
will be terminated forcibly via
SIGTERM, and after another delay of
this time with SIGKILL. (See
- below.)
+ below.)
Takes a unit-less value in seconds, or
a time span value such as "5min
20s". Pass 0 to disable the timeout
@@ -462,11 +464,10 @@
60s.
-
KillMode=Specifies how
- processes of this service shall be
+ processes of this socket unit shall be
killed. One of
,
,
@@ -479,8 +480,6 @@
systemd.service5
for details.
-
-