|
 |
7f93bc2 |
From 4a8d7c028dea812fd6fbe27ed6ecc1e9beba2738 Mon Sep 17 00:00:00 2001
|
|
|
a59965a |
From: Lennart Poettering <lennart@poettering.net>
|
|
|
a59965a |
Date: Tue, 10 Jun 2014 18:52:28 +0200
|
|
|
a59965a |
Subject: [PATCH] man: updates to the passive target section
|
|
|
a59965a |
|
|
|
a59965a |
(cherry picked from commit 51cb9d734a182c4892a6b31f58d75489a2ca432b)
|
|
|
a59965a |
(cherry picked from commit 1f98d3636de425d9c49cd0dcb889865fbb996924)
|
|
|
a59965a |
---
|
|
|
a59965a |
man/systemd.special.xml | 58 ++++++++++++++++++++++++++++++++++++-------------
|
|
|
a59965a |
1 file changed, 43 insertions(+), 15 deletions(-)
|
|
|
a59965a |
|
|
|
a59965a |
diff --git a/man/systemd.special.xml b/man/systemd.special.xml
|
|
|
a59965a |
index 8ccccc2..38b94a7 100644
|
|
|
a59965a |
--- a/man/systemd.special.xml
|
|
|
a59965a |
+++ b/man/systemd.special.xml
|
|
|
a59965a |
@@ -866,7 +866,13 @@
|
|
|
a59965a |
will be stopped before the
|
|
|
a59965a |
network -- to whatever level
|
|
|
a59965a |
it might be set up then -- is
|
|
|
a59965a |
- shut down. Also see
|
|
|
a59965a |
+ shut down. It is hence useful
|
|
|
a59965a |
+ when writing service files
|
|
|
a59965a |
+ that require network access on
|
|
|
a59965a |
+ shutdown, which should order
|
|
|
a59965a |
+ themselves after this target,
|
|
|
a59965a |
+ but not pull it in. Also see
|
|
|
a59965a |
+
|
|
|
a59965a |
url="http://www.freedesktop.org/wiki/Software/systemd/NetworkTarget">Running
|
|
|
a59965a |
Services After the Network is
|
|
|
a59965a |
up</ulink> for more
|
|
|
a59965a |
@@ -882,7 +888,6 @@
|
|
|
a59965a |
an LSB header referring to the
|
|
|
a59965a |
<literal>$network</literal>
|
|
|
a59965a |
facility.</para>
|
|
|
a59965a |
-
|
|
|
a59965a |
</listitem>
|
|
|
a59965a |
</varlistentry>
|
|
|
a59965a |
<varlistentry>
|
|
|
a59965a |
@@ -896,7 +901,12 @@
|
|
|
a59965a |
user/group name lookups for
|
|
|
a59965a |
which
|
|
|
a59965a |
<filename>nss-user-lookup.target</filename>
|
|
|
a59965a |
- should be used. systemd
|
|
|
a59965a |
+ should be used. All services
|
|
|
a59965a |
+ for which the availability of
|
|
|
a59965a |
+ full host/network name
|
|
|
a59965a |
+ resolution is essential should
|
|
|
a59965a |
+ be ordered after this target,
|
|
|
a59965a |
+ but not pull it in. systemd
|
|
|
a59965a |
automatically adds
|
|
|
a59965a |
dependencies of type
|
|
|
a59965a |
<varname>After=</varname> for
|
|
|
a59965a |
@@ -918,7 +928,16 @@
|
|
|
a59965a |
host/network name lookups for
|
|
|
a59965a |
which
|
|
|
a59965a |
<filename>nss-lookup.target</filename>
|
|
|
a59965a |
- should be used. </para>
|
|
|
a59965a |
+ should be used. All services
|
|
|
a59965a |
+ for which the availability of
|
|
|
a59965a |
+ the full user/group database is
|
|
|
a59965a |
+ essential should be ordered
|
|
|
a59965a |
+ after this target, but not
|
|
|
a59965a |
+ pull it in. Note that system
|
|
|
a59965a |
+ users are always resolvable,
|
|
|
a59965a |
+ and hence do not require any
|
|
|
a59965a |
+ special ordering against this
|
|
|
a59965a |
+ target.</para>
|
|
|
a59965a |
</listitem>
|
|
|
a59965a |
</varlistentry>
|
|
|
a59965a |
<varlistentry>
|
|
|
a59965a |
@@ -943,19 +962,18 @@
|
|
|
a59965a |
should use
|
|
|
a59965a |
<filename>network-online.target</filename>
|
|
|
a59965a |
(see above).</para>
|
|
|
a59965a |
-
|
|
|
a59965a |
- <para>Again, this target unit
|
|
|
a59965a |
- is <emphasis>not</emphasis>
|
|
|
a59965a |
- suitable for pulling in other
|
|
|
a59965a |
- units, it is only useful for
|
|
|
a59965a |
- ordering.</para>
|
|
|
a59965a |
</listitem>
|
|
|
a59965a |
</varlistentry>
|
|
|
a59965a |
<varlistentry>
|
|
|
a59965a |
<term><filename>rpcbind.target</filename></term>
|
|
|
a59965a |
<listitem>
|
|
|
a59965a |
- <para>systemd automatically
|
|
|
a59965a |
- adds dependencies of type
|
|
|
a59965a |
+ <para>The portmapper/rpcbind
|
|
|
a59965a |
+ pulls in this target and
|
|
|
a59965a |
+ orders itself before it, to
|
|
|
a59965a |
+ indicate its
|
|
|
a59965a |
+ availability. systemd
|
|
|
a59965a |
+ automatically adds
|
|
|
a59965a |
+ dependencies of type
|
|
|
a59965a |
<varname>After=</varname> for
|
|
|
a59965a |
this target unit to all SysV
|
|
|
a59965a |
init script service units with
|
|
|
a59965a |
@@ -967,14 +985,24 @@
|
|
|
a59965a |
<varlistentry>
|
|
|
a59965a |
<term><filename>time-sync.target</filename></term>
|
|
|
a59965a |
<listitem>
|
|
|
a59965a |
- <para>systemd automatically
|
|
|
a59965a |
- adds dependencies of type
|
|
|
a59965a |
+ <para>Services responsible for
|
|
|
a59965a |
+ synchronizing the system clock
|
|
|
a59965a |
+ from a remote source (such as
|
|
|
a59965a |
+ NTP client implementations)
|
|
|
a59965a |
+ should pull in this target and
|
|
|
a59965a |
+ order themselves before
|
|
|
a59965a |
+ it. All services where correct
|
|
|
a59965a |
+ time is essential should be
|
|
|
a59965a |
+ ordered after this unit, but
|
|
|
a59965a |
+ not pull it in. systemd
|
|
|
a59965a |
+ automatically adds
|
|
|
a59965a |
+ dependencies of type
|
|
|
a59965a |
<varname>After=</varname> for
|
|
|
a59965a |
this target unit to all SysV
|
|
|
a59965a |
init script service units with
|
|
|
a59965a |
an LSB header referring to the
|
|
|
a59965a |
<literal>$time</literal>
|
|
|
a59965a |
- facility.</para>
|
|
|
a59965a |
+ facility. </para>
|
|
|
a59965a |
</listitem>
|
|
|
a59965a |
</varlistentry>
|
|
|
a59965a |
</variablelist>
|