X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.special.xml;h=38b94a7657ed49a86c4390f7f4734e714f285467;hb=06c17c39a8345deef1ecff4dd5ef262f968c9be2;hp=4d0660714531f45d3227de3a5e258fdb0d6e45f8;hpb=6b4991cfde6c0a0b62e836ca75ae362779c474d4;p=elogind.git
diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index 4d0660714..38b94a765 100644
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -820,7 +820,7 @@
services. These targets are generally not part of the
initial boot transaction, unless they are explicitly
pulled in by one of the implementing services. Note
- specifically, that these passive
+ specifically that these passive
target units are generally not pulled in by the
consumer of a service, but by the provider of the
service. This means: a consuming service should order
@@ -866,7 +866,13 @@
will be stopped before the
network -- to whatever level
it might be set up then -- is
- shut down. Also see Running
Services After the Network is
up for more
@@ -882,7 +888,6 @@
an LSB header referring to the
$network
facility.
-
@@ -896,7 +901,12 @@
user/group name lookups for
which
nss-user-lookup.target
- 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
After= for
@@ -918,7 +928,16 @@
host/network name lookups for
which
nss-lookup.target
- should be used.
+ 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.
@@ -939,23 +958,22 @@
Wants= type
dependency. If the unit wants
to be pulled in by the first
- remote mount showing up it
+ remote mount showing up, it
should use
network-online.target
(see above).
-
- Again, this target unit
- is not
- suitable for pulling in other
- units, it is only useful for
- ordering.
rpcbind.target
- systemd automatically
- adds dependencies of type
+ The portmapper/rpcbind
+ pulls in this target and
+ orders itself before it, to
+ indicate its
+ availability. systemd
+ automatically adds
+ dependencies of type
After= for
this target unit to all SysV
init script service units with
@@ -967,14 +985,24 @@
time-sync.target
- systemd automatically
- adds dependencies of type
+ 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
After= for
this target unit to all SysV
init script service units with
an LSB header referring to the
$time
- facility.
+ facility.
@@ -996,7 +1024,7 @@
smartcard.target,
sound.target.
- In addition the following special unit is
+ In addition, the following special unit is
understood only when systemd runs as service instance:
@@ -1012,7 +1040,7 @@
manager should start this
unit. If systemd receives
SIGTERM or SIGINT when running
- as user service daemon it will
+ as user service daemon, it will
start this unit.
Normally, this pulls in