From 4a8d7c028dea812fd6fbe27ed6ecc1e9beba2738 Mon Sep 17 00:00:00 2001

From: Lennart Poettering <lennart@poettering.net>

Date: Tue, 10 Jun 2014 18:52:28 +0200

Subject: [PATCH] man: updates to the passive target section

(cherry picked from commit 51cb9d734a182c4892a6b31f58d75489a2ca432b)

(cherry picked from commit 1f98d3636de425d9c49cd0dcb889865fbb996924)

---

 man/systemd.special.xml | 58 ++++++++++++++++++++++++++++++++++++-------------

 1 file changed, 43 insertions(+), 15 deletions(-)

diff --git a/man/systemd.special.xml b/man/systemd.special.xml

index 8ccccc2..38b94a7 100644

--- a/man/systemd.special.xml

+++ b/man/systemd.special.xml

@@ -866,7 +866,13 @@

                                         will be stopped before the

                                         network -- to whatever level

                                         it might be set up then -- is

-                                        shut down. Also see 

+                                        shut down. It is hence useful

+                                        when writing service files

+                                        that require network access on

+                                        shutdown, which should order

+                                        themselves after this target,

+                                        but not pull it in. Also see

+                                        

                                         url="http://www.freedesktop.org/wiki/Software/systemd/NetworkTarget">Running

                                         Services After the Network is

                                         up</ulink> for more

@@ -882,7 +888,6 @@

                                         an LSB header referring to the

                                         <literal>$network</literal>

                                         facility.</para>

-

                                 </listitem>

                         </varlistentry>

                         <varlistentry>

@@ -896,7 +901,12 @@

                                         user/group name lookups for

                                         which

                                         <filename>nss-user-lookup.target</filename>

-                                        should be used. systemd

+                                        should be used. All services

+                                        for which the availability of

+                                        full host/network name

+                                        resolution is essential should

+                                        be ordered after this target,

+                                        but not pull it in. systemd

                                         automatically adds

                                         dependencies of type

                                         <varname>After=</varname> for

@@ -918,7 +928,16 @@

                                         host/network name lookups for

                                         which

                                         <filename>nss-lookup.target</filename>

-                                        should be used. </para>

+                                        should be used. All services

+                                        for which the availability of

+                                        the full user/group database is

+                                        essential should be ordered

+                                        after this target, but not

+                                        pull it in. Note that system

+                                        users are always resolvable,

+                                        and hence do not require any

+                                        special ordering against this

+                                        target.</para>

                                 </listitem>

                         </varlistentry>

                         <varlistentry>

@@ -943,19 +962,18 @@

                                         should use

                                         <filename>network-online.target</filename>

                                         (see above).</para>

-

-                                        <para>Again, this target unit

-                                        is <emphasis>not</emphasis>

-                                        suitable for pulling in other

-                                        units, it is only useful for

-                                        ordering.</para>

                                 </listitem>

                         </varlistentry>

                         <varlistentry>

                                 <term><filename>rpcbind.target</filename></term>

                                 <listitem>

-                                        <para>systemd automatically

-                                        adds dependencies of type

+                                        <para>The portmapper/rpcbind

+                                        pulls in this target and

+                                        orders itself before it, to

+                                        indicate its

+                                        availability. systemd

+                                        automatically adds

+                                        dependencies of type

                                         <varname>After=</varname> for

                                         this target unit to all SysV

                                         init script service units with

@@ -967,14 +985,24 @@

                         <varlistentry>

                                 <term><filename>time-sync.target</filename></term>

                                 <listitem>

-                                        <para>systemd automatically

-                                        adds dependencies of type

+                                        <para>Services responsible for

+                                        synchronizing the system clock

+                                        from a remote source (such as

+                                        NTP client implementations)

+                                        should pull in this target and

+                                        order themselves before

+                                        it. All services where correct

+                                        time is essential should be

+                                        ordered after this unit, but

+                                        not pull it in. systemd

+                                        automatically adds

+                                        dependencies of type

                                         <varname>After=</varname> for

                                         this target unit to all SysV

                                         init script service units with

                                         an LSB header referring to the

                                         <literal>$time</literal>

-                                        facility.</para>

+                                        facility. </para>

                                 </listitem>

                         </varlistentry>

                 </variablelist>