X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.special.xml;h=6b8e0ec7f0b8fe7cedc9a95ada2622a690dc0940;hp=116a43ccfb30798e6570fdeb43df6ac2963c962c;hb=6524990fdc98370ecba5d9f73e67161e8798c010;hpb=19c5f19d69bb5f520fa7213239490c55de06d99d
diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index 116a43ccf..6b8e0ec7f 100644
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -8,16 +8,16 @@
Copyright 2010 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Lesser General Public License for more details.
- You should have received a copy of the GNU General Public License
+ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
@@ -44,27 +44,38 @@
systemd.special
- special systemd units
+ Special systemd units
basic.target,
+ bluetooth.target,
ctrl-alt-del.target,
+ cryptsetup.target,
dbus.service,
+ dbus.socket,
default.target,
display-manager.service,
emergency.target,
- exit.service,
+ exit.target,
+ final.target,
+ getty.target,
graphical.target,
+ hibernate.target,
+ http-daemon.target,
+ hybrid-sleep.target,
halt.target,
kbrequest.target,
+ kexec.target,
local-fs.target,
local-fs-pre.target,
mail-transfer-agent.target,
multi-user.target,
network.target,
nss-lookup.target,
+ nss-user-lookup.target,
poweroff.target,
+ printer.target,
reboot.target,
remote-fs.target,
remote-fs-pre.target,
@@ -76,14 +87,16 @@
runlevel5.target,
shutdown.target,
sigpwr.target,
+ sleep.target,
+ smartcard.target,
sockets.target,
+ sound.target,
+ suspend.target,
swap.target,
sysinit.target,
+ syslog.socket,
syslog.target,
- systemd-initctl.service,
- systemd-initctl.socket,
- systemd-stdout-syslog-bridge.service,
- systemd-stdout-syslog-bridge.socket,
+ system-update.target,
time-sync.target,
umount.target
@@ -122,6 +135,16 @@
this unit.
+
+ bluetooth.target
+
+ This target is started
+ automatically as soon as a
+ bluetooth controller is
+ plugged in or becomes
+ available at boot.
+
+
ctrl-alt-del.target
@@ -134,6 +157,15 @@
reboot.target.
+
+ cryptsetup.target
+
+ A target that pulls in
+ setup services for all
+ encrypted block
+ devices.
+
+
dbus.service
@@ -145,6 +177,18 @@
service.
+
+ dbus.socket
+
+ A special unit for the
+ D-Bus system bus socket. All
+ units with
+ Type=dbus
+ automatically gain a
+ dependency on this
+ unit.
+
+
default.target
@@ -168,7 +212,7 @@
The display manager
service. Usually this should
be aliased (symlinked) to
- xdm.service
+ gdm.service
or a similar display manager
service.
systemd automatically
@@ -196,6 +240,28 @@
+
+ final.target
+
+ A special target unit
+ that is used during the
+ shutdown logic and may be used
+ to pull in late services after
+ all normal services are
+ already terminated and all
+ mounts unmounted.
+
+
+
+
+ getty.target
+
+ A special target unit
+ that pulls in all local TTY
+ getty instances.
+
+
+
graphical.target
@@ -212,6 +278,40 @@
during installation.
+
+ hibernate.target
+
+ A special target unit
+ for hibernating the
+ system. This pulls in
+ sleep.target.
+
+
+
+ http-daemon.target
+
+ A target for pulling in
+ an HTTP server if there is
+ any.
+ systemd automatically
+ adds dependencies of type
+ After for this target unit to
+ all SysV init script service
+ units with a LSB header
+ referring to the
+ $httpd
+ facility.
+
+
+
+ hybrid-sleep.target
+
+ A special target unit
+ for hibernating and suspending the
+ system at the same time. This pulls in
+ sleep.target.
+
+
halt.target
@@ -234,6 +334,17 @@
rescue.target.
+
+ kexec.target
+
+ A special target unit
+ for shutting down and rebooting the system via kexec.
+
+ Applications wanting to
+ reboot the system with kexec should start
+ this unit.
+
+
local-fs.target
@@ -329,16 +440,38 @@
nss-lookup.target
- 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
+ A target that should be
+ used as synchronization point
+ for all host/network name
+ service lookups. Note that
+ this is independent of
+ user/group name lookups for
+ which
+ nss-user-lookup.target
+ should be used. 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
$named
facility.
+
+ nss-user-lookup.target
+
+ A target that should be
+ used as synchronization point
+ for all user/group name
+ service lookups. Note that
+ this is independent of
+ host/network name lookups for
+ which
+ nss-lookup.target
+ should be used.
+
+
poweroff.target
@@ -354,6 +487,16 @@
unit, for compatibility with SysV.
+
+ printer.target
+
+ This target is started
+ automatically as soon as a
+ printer is plugged in or
+ becomes available at
+ boot.
+
+
reboot.target
@@ -420,7 +563,7 @@
all SysV init script service
units with an LSB header
referring to the
- $rpcbind
+ $portmap
facility.
@@ -514,6 +657,28 @@
power fails.
+
+ sleep.target
+
+ A special target unit
+ that is pulled in by
+ suspend.target,
+ hibernate.target and hybrid-sleep.target
+ and may be used to hook units
+ into the sleep state
+ logic.
+
+
+
+ smartcard.target
+
+ This target is started
+ automatically as soon as a
+ smartcard controller is
+ plugged in or becomes
+ available at boot.
+
+
sockets.target
@@ -528,6 +693,25 @@
during installation.
+
+ sound.target
+
+ This target is started
+ automatically as soon as a
+ sound card is plugged in or
+ becomes available at
+ boot.
+
+
+
+ suspend.target
+
+ A special target unit
+ for suspending the
+ system. This pulls in
+ sleep.target.
+
+
swap.target
@@ -554,6 +738,22 @@
or b.
+
+ syslog.socket
+
+ The socket unit where
+ syslog implementations should
+ listen on. All userspace log
+ messages will be made
+ available on this socket. For
+ more information about syslog
+ integration, please consult
+ the Syslog
+ Interface
+ document.
+
+
syslog.target
@@ -568,71 +768,20 @@
- systemd-initctl.service
-
- This provides
- compatibility with the SysV
- /dev/initctl file system FIFO
- for communication with the
- init system.
- This is a
- socket-activated service, see
- system-initctl.socket.
-
-
-
- systemd-initctl.socket
-
- Socket activation unit
- for
- system-initctl.service.
-
-
-
- systemd-stdout-syslog-bridge.service
-
- This is internally used
- by systemd to provide syslog
- logging to the processes it
- maintains.
- This is a
- socket-activated service, see
- system-stdout-syslog-bridge.socket.
-
-
-
- systemd-stdout-syslog-bridge.socket
-
- Socket activation unit
- for
- system-stdout-syslog-bridge.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.
-
-
-
- systemd-shutdownd.service
-
- This is internally used
- by
- shutdown8
- to implement delayed shutdowns.
- This is a
- socket-activated service, see
- system-shutdownd.socket.
-
-
-
- systemd-shutdownd.socket
+ system-update.target
- Socket activation unit
- for
- system-shutdownd.service.
+ A special target unit
+ that is used for off-line
+ system updates.
+ systemd-system-update-generator8
+ will redirect the boot process
+ to this target if
+ /system-update
+ exists. For more information
+ see the System
+ Updates
+ Specification.
@@ -666,6 +815,7 @@
is set (the default).
+
@@ -676,18 +826,15 @@
following special units are available, which have
similar definitions as their system counterparts:
default.target,
- local-fs.target,
- remote-fs.target,
shutdown.target,
- sockets.target,
- swap.target.
+ sockets.target
In addition the following special unit is
understood only when systemd runs as service instance:
- exit.service
+ exit.target
A special service unit
for shutting down the
@@ -715,10 +862,12 @@
See Also
+ systemd1,
systemd.unit5,
systemd.service5,
systemd.socket5,
- systemd.target5
+ systemd.target5,
+ bootup7