Commit 1f812fea authored by Lennart Poettering's avatar Lennart Poettering
Browse files

man: document socket units

parent c0115b1f
......@@ -317,6 +317,7 @@ MANPAGES = \
man/sd_is_fifo.3 \
man/systemd.unit.5 \
man/systemd.service.5 \
man/systemd.socket.5 \
man/daemon.7 \
man/sd-daemon.7 \
man/runlevel.8 \
......@@ -54,9 +54,9 @@
<para>A configuration file ending in .service encodes
information about a process controlled and supervised
by systemd.</para>
<para>A unit configuration file whose name ends in
.service encodes information about a process
controlled and supervised by systemd.</para>
<para>This man page lists the configuration options
specific to this unit type. See
......@@ -308,7 +308,7 @@
forcibly via SIGTERM, and after
another delay of this time with
below.) Takes a unit-less value in seconds, or a
time span value such as "5min
20s". Pass 0 to disable the timeout
This diff is collapsed.
......@@ -144,6 +144,44 @@
activation which makes dependencies implicit, which
both results in a simpler and more flexible
<para>Some unit names reflect paths existing in the
file system name space. Example: a device unit
<filename>dev-sda.device</filename> refers to a device
with the device node <filename>/dev/sda</filename> in
the file system namespace. If this applies a special
way to escape the path name is used, so that it is
usable as part of a file name. Basically, given a path,
"/" is replaced by "-", and all unprintable characters
and the "-" are replaced by C-style "\x20"
escapes. This escaping is reversible.</para>
<para>Optionally, units may be instantiated from a
template file at runtime. This allows creation of
multiple units from a single configuration file. If
systemd looks for a unit configuration file it will
first search for the literal unit name in the
filesystem. If that yields no success and the unit
name contains an @ character, systemd will look for a
unit template that shares the same name but with the
instance string (i.e. the part between the @ character
and the suffix) removed. Example: if a service
<filename>getty@tty3.service</filename> is requested
and no file by that name is found, systemd will look
for <filename>getty@.service</filename> and
instantiate a service from that configuration file if
it is found. To refer to the instance string from
within the configuration file you may use the special
<literal>%i</literal> specifier in many of the
configuration options. Other specifiers that may be
used are <literal>%n</literal>, <literal>%N</literal>,
<literal>%p</literal>, <literal>%P</literal> and
<literal>%I</literal>, for the full unit name, the
unescaped unit name, the prefix name, the unescaped
prefix name and the unescaped instance name,
respectively. The prefix name here refers to the
string before the @, i.e. "getty" in the example
above, where "tty3" is the instance name.</para>
......@@ -66,15 +66,10 @@ static void socket_init(Unit *u) {
s->max_connections = 64;
s->keep_alive = false;
s->priority = -1;
s->receive_buffer = 0;
s->send_buffer = 0;
s->ip_tos = -1;
s->ip_ttl = -1;
s->pipe_size = 0;
s->mark = -1;
s->free_bind = false;
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment