summaryrefslogtreecommitdiff
path: root/man/systemd.socket.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2010-07-02 01:17:55 +0200
committerLennart Poettering <lennart@poettering.net>2010-07-02 01:17:55 +0200
commit65232ea79d8f6b1288c33852f89b575a9200162d (patch)
treeb10c403e286e4453ab44ec3343b37fd3f103a27d /man/systemd.socket.xml
parent1cf18f27331286dfb56d92e1800facf4f696ad27 (diff)
man: document automount units
Diffstat (limited to 'man/systemd.socket.xml')
-rw-r--r--man/systemd.socket.xml31
1 files changed, 19 insertions, 12 deletions
diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml
index 65ef8c0b1a..e15ea602f4 100644
--- a/man/systemd.socket.xml
+++ b/man/systemd.socket.xml
@@ -54,10 +54,11 @@
<refsect1>
<title>Description</title>
- <para>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.</para>
+ <para>A unit configuration file whose name ends in
+ <filename>.socket</filename> encodes information about
+ an IPC or network socket or a file system FIFO
+ controlled and supervised by systemd, for socket-based
+ activation.</para>
<para>This man page lists the configuration options
specific to this unit type. See
@@ -71,13 +72,15 @@
<para>Additional options are listed in
<citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
- <para>For each socket file a matching service file (see <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry> for details)
- must exist, describing the service to start on
- incoming traffic on the socket. Depending on the
- setting of <option>Accept=</option> (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
+ <para>For each socket file a matching service file
+ (see
+ <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+ for details) must exist, describing the service to
+ start on incoming traffic on the socket. Depending on
+ the setting of <option>Accept=</option> (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
<filename>foo.socket</filename> needs a matching
service <filename>foo.service</filename> if
<option>Accept=false</option> is set. If
@@ -85,6 +88,10 @@
file <filename>foo@.service</filename> must exist from
which services are instantiated for each incoming
connection.</para>
+
+ <para>Socket units may be used to implement on-demand
+ starting of services as well as parallelized starting
+ of services.</para>
</refsect1>
<refsect1>
@@ -96,7 +103,7 @@
this section are shared with other unit types. These
options are documented in
<citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>. The
- options specific to the [Socket] section of service
+ options specific to the [Socket] section of socket
units are the following:</para>
<variablelist>