diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index 3f9286d4b4e..e81e99e44ef 100644
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -48,22 +48,38 @@
+ basic.target
+ ctrl-alt-del.target
+ default.target
emergency.service
+ graphical.target
+ halt.target
+ kbrequest.target
local-fs.target
+ multi-user.target
network.target
nss-lookup.target
+ poweroff.target
+ reboot.target
remote-fs.target
+ rescue.target
rpcbind.target
rtc-set.target
+ runlevel0.target,
+ runlevel0.target,
+ runlevel1.target,
+ runlevel2.target,
+ runlevel3.target,
+ runlevel4.target,
+ runlevel5.target,
+ runlevel6.target
shutdown.target
sigpwr.target
sockets.target
swap.target
syslog.target
- systemd-initctl.service
- systemd-initctl.socket
- systemd-logger.service
- systemd-logger.socket
+ systemd-initctl.service, systemd-initctl.socket
+ systemd-logger.service, systemd-logger.socket
@@ -78,6 +94,58 @@
Special System Units
+
+ basic.target
+
+ A special target unit
+ covering early boot-up.
+ systemd automatically
+ adds dependencies of the types
+ Requires and After for this
+ target unit to all SysV
+ service units configured for
+ runlevel 1 to 5.
+ systemd automatically
+ adds dependencies of the types
+ Wants and After for all
+ SysV service units configured
+ for runlevels that are not 0
+ to 6 to this target unit.
+ This covers the special
+ boot-up runlevels some
+ distributions have, such as S
+ or b.
+
+
+
+ ctrl-alt-del.target
+
+ systemd starts this
+ target whenever
+ Control+Alt+Del is pressed on
+ the console. Usually this
+ should be aliased (symlinked)
+ to
+ reboot.target.
+
+
+
+ default.target
+
+ The default unit systemd
+ starts at bootup. Usually this
+ should be aliased (symlinked)
+ to
+ multi-user.target
+ or
+ graphical.target.
+ The default unit systemd
+ starts at bootup can be
+ overriden with the
+ systemd.default=
+ kernel command line option.
+
+
emergency.service
@@ -92,17 +160,56 @@
+
+ graphical.target
+
+ A special target unit
+ for setting up a graphical
+ login screen. This pulls in
+ multi-user.target.
+
+ Units that are needed
+ for graphical login shall add
+ Wants dependencies for their
+ unit to this unit (or
+ multi-user.target)
+ during installation.
+
+
+
+ halt.target
+
+ A special target unit
+ for shutting down and halting the system.
+
+ Applications wanting to
+ halt the system should start
+ this unit.
+
+
+
+ kbrequest.target
+
+ systemd starts this
+ target whenever Alt+ArrowUp is
+ pressed on the console. This
+ is a good candidate to be
+ aliased (symlinked) to
+ rescue.target.
+
+
local-fs.target
systemd automatically
adds dependencies of type
After to all mount units that
- refer to local mount
- points. In addition, systemd
- adds dependencies of type
- Wants to those mounts listed
- in
+ refer to local mount points
+ for this target unit. In
+ addition, systemd adds
+ dependencies of type Wants to
+ this target unit for those
+ mounts listed in
/etc/fstab
that have the
auto and
@@ -111,21 +218,39 @@
systemd automatically
adds dependencies of type
- After to this target unit for
- all SysV init scripts with an
- LSB header referring to the
+ After for this target unit to
+ all SysV init script service
+ units with an LSB header
+ referring to the
$local_fs
facility.
+
+ multi-user.target
+
+ A special target unit
+ for setting up a multi-user
+ system (non-graphical). This
+ is pulled in by
+ graphical.target.
+
+ Units that are needed
+ for a multi-user system shall
+ add Wants dependencies to
+ this unit for their unit during
+ installation.
+
+
network.target
systemd automatically
adds dependencies of type
- After to this target unit for
- all SysV init scripts with an
- LSB header referring to the
+ After for this target unit to
+ all SysV init script service
+ units with an LSB header
+ referring to the
$network
facility.
@@ -135,34 +260,83 @@
systemd automatically
adds dependencies of type
- After to this target unit for
- all SysV init scripts with an
- LSB header referring to the
+ After for this target unit to
+ all SysV init script service
+ units with an LSB header
+ referring to the
$named
facility.
+
+ poweroff.target
+
+ A special target unit
+ for shutting down and powering off the system.
+
+ Applications wanting to
+ power off the system should start
+ this unit.
+
+ runlevel0.target
+ is an alias for this target
+ unit, for compatibility with SysV.
+
+
+
+ reboot.target
+
+ A special target unit
+ for shutting down and rebooting the system.
+
+ Applications wanting to
+ reboot the system should start
+ this unit.
+
+ runlevel6.target
+ is an alias for this target
+ unit, for compatibility with SysV.
+
+
remote-fs.target
- Similar to local-fs.target, but for remote mount points.
+ Similar to
+ local-fs.target,
+ but for remote mount
+ points.
+
systemd automatically
adds dependencies of type
- After to this target unit for
- all SysV init scripts with an
- LSB header referring to the
+ After for this target unit to
+ all SysV init script service
+ units with an LSB header
+ referring to the
$remote-fs
facility.
+
+ rescue.target
+
+ A special target unit
+ for setting up the base system
+ and a rescue shell.
+
+ runlevel1.target
+ is an alias for this target
+ unit, for compatibility with SysV.
+
+
rpcbind.target
systemd automatically
adds dependencies of type
- After to this target unit for
- all SysV init scripts with an
- LSB header referring to the
+ After for this target unit to
+ all SysV init script service
+ units with an LSB header
+ referring to the
$rpcbind
facility.
@@ -172,13 +346,107 @@
systemd automatically
adds dependencies of type
- After to this target unit for
- all SysV init scripts with an
- LSB header referring to the
+ After for this target unit to
+ all SysV init script service
+ units with an LSB header
+ referring to the
$time
facility.
+
+ runlevel0.target
+
+ This is a target that is
+ called whever the SysV
+ compatibility code asks for
+ runlevel 0. This is an alias
+ for
+ poweroff.target,
+ for compatibility with
+ SysV.
+
+
+
+ runlevel1.target
+
+ This is a target that is
+ called whever the SysV
+ compatibility code asks for
+ runlevel 1. This is an alias
+ for
+ rescue.target,
+ for compatibility with
+ SysV.
+
+
+
+ runlevel2.target
+
+ This is a target that is
+ called whever the SysV
+ compatibility code asks for
+ runlevel 2. It is a good idea
+ to make this an alias for
+ (i.e. symlink to)
+ multi-user.target.
+
+
+
+ runlevel3.target
+
+ This is a target that is
+ called whever the SysV
+ compatibility code asks for
+ runlevel 3. It is a good idea
+ to make this an alias for
+ (i.e. symlink to)
+ multi-user.target
+ or
+ graphical.target.
+
+
+
+ runlevel4.target
+
+ This is a target that is
+ called whever the SysV
+ compatibility code asks for
+ runlevel 4. It is a good idea
+ to make this an alias for
+ (i.e. symlink to)
+ multi-user.target
+ or
+ graphical.target.
+
+
+
+ runlevel5.target
+
+ This is a target that is
+ called whever the SysV
+ compatibility code asks for
+ runlevel 5. It is a good idea
+ to make this an alias for
+ (i.e. symlink to)
+ multi-user.target
+ or
+ graphical.target.
+
+
+
+ runlevel6.target
+
+ This is a target that is
+ called whever the SysV
+ compatibility code asks for
+ runlevel 6. This is an alias
+ for
+ reboot.target,
+ for compatibility with
+ SysV.
+
+
shutdown.target
@@ -188,17 +456,18 @@
Services that shall be
terminated on system shutdown
- shall add Wants dependencies
- from this unit to their
- service unit during
+ shall add Conflicts
+ dependencies to this unit for
+ their service unit during
installation.
systemd automatically
adds dependencies of type
Conflicts to this target unit
- for all SysV init scripts that
- shall be terminated in SysV
- runlevels 0 or 6.
+ for all SysV init script
+ service units that shall be
+ terminated in SysV runlevels 0
+ or 6.
@@ -208,7 +477,7 @@
started when systemd receives
the SIGPWR process signal,
which is normally sent by the
- kernel or UPS daemons when the
+ kernel or UPS daemons when
power fails.
@@ -221,8 +490,8 @@
Services that can be
socket-activated shall add
- Wants dependencies from this
- unit to their socket unit
+ Wants dependencies to this
+ unit for their socket unit
during installation.
@@ -240,9 +509,10 @@
systemd automatically
adds dependencies of type
- After to this target unit for
- all SysV init scripts with an
- LSB header referring to the
+ After for this target unit to
+ all SysV init script service
+ units with an LSB header
+ referring to the
$syslog
facility.
@@ -250,9 +520,10 @@
ensure that this target pulls
in a service unit with the
name or alias of
- @SPECIAL_SYSLOG_NAME@ (or a
- socket unit that activates
- this service).
+ @SPECIAL_SYSLOG_SERVICE@
+ (or a socket unit that
+ activates this
+ service).
@@ -279,10 +550,10 @@
systemd-logger.service
- This is used internally
+ This is internally used
by systemd to provide syslog
- logging to started
- processes.
+ logging to the processes it
+ maintains.
This is a
socket-activated service, see
system-logger.socket.
@@ -293,7 +564,14 @@
Socket activation unit
for
- system-logger.service.
+ system-logger.service. systemd
+ will automatically add
+ dependencies of types Requires
+ and After to all units that
+ have been configured for
+ stdout or stderr to be
+ connected to syslog or the
+ kernel log buffer.
@@ -305,6 +583,7 @@
When systemd runs as a service instance, the
following special units are available, which have
similar definitions as their system counterparts:
+ default.target,
local-fs.target,
remote-fs.target,
shutdown.target,