X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.special.xml;h=67a81b639b8d115df3700324f969c3bb550f05ee;hb=bfa00bc6c05d0f896e9632eccd47d442fea556b9;hp=fe85137ffe33f15bf5de84bd1aa9403172a54b6e;hpb=6df831f25ebc9f55cd939f04392dad9237706e45;p=elogind.git
diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index fe85137ff..67a81b639 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 .
-->
@@ -49,30 +49,37 @@
basic.target,
+ bluetooth.target,
ctrl-alt-del.target,
+ cryptsetup.target,
dbus.service,
dbus.socket,
default.target,
display-manager.service,
emergency.target,
- exit.service,
- final.service,
+ exit.target,
+ final.target,
+ getty.target,
graphical.target,
- http-daemon.target,
halt.target,
+ hibernate.target,
+ hybrid-sleep.target,
+ initrd-fs.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,
rescue.target,
+ initrd-root-fs.target,
rpcbind.target,
runlevel2.target,
runlevel3.target,
@@ -80,12 +87,15 @@
runlevel5.target,
shutdown.target,
sigpwr.target,
+ sleep.target,
+ smartcard.target,
sockets.target,
+ sound.target,
+ suspend.target,
swap.target,
sysinit.target,
- syslog.service,
syslog.socket,
- syslog.target,
+ system-update.target,
time-sync.target,
umount.target
@@ -124,6 +134,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
@@ -136,6 +156,15 @@
reboot.target.
+
+ cryptsetup.target
+
+ A target that pulls in
+ setup services for all
+ encrypted block
+ devices.
+
+ dbus.service
@@ -185,15 +214,6 @@
gdm.service
or a similar display manager
service.
- 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
- $x-display-manager
- facility, for compatibility
- with Debian.
@@ -223,6 +243,15 @@
+
+ getty.target
+
+ A special target unit
+ that pulls in all local TTY
+ getty instances.
+
+
+ graphical.target
@@ -240,19 +269,21 @@
- http-daemon.target
+ hibernate.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.
+ A special target unit
+ for hibernating the
+ system. This pulls in
+ sleep.target.
+
+
+
+ hybrid-sleep.target
+
+ A special target unit
+ for hibernating and suspending the
+ system at the same time. This pulls in
+ sleep.target.
@@ -266,6 +297,22 @@
this unit.
+
+ initrd-fs.target
+
+ systemd automatically
+ adds dependencies of type
+ Before to sysroot-usr.mount and
+ all mount points fround in
+ /etc/fstab
+ that have the
+ and
+
+ mount options set.
+ See also systemd-fstab-generator.
+
+
+ kbrequest.target
@@ -305,15 +352,6 @@
and
mount options set.
-
- 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
- $local_fs
- facility.
@@ -328,29 +366,6 @@
all local mounts.
-
- mail-transfer-agent.target
-
- The mail transfer agent
- (MTA) service. Usually this
- should pull-in all units
- necessary for
- sending/receiving mails on the
- local host.
-
- 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
- $mail-transfer-agent
- or
- $mail-transport-agent
- facilities, for compatibility
- with Debian.
-
- multi-user.target
@@ -378,21 +393,53 @@
referring to the
$network
facility.
+
+ This unit is supposed to
+ indicate when the network is
+ "up", but it is only very
+ loosely defined what that is
+ supposed to mean. Also see Running
+ Services After the Network is
+ up for more
+ information.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
@@ -408,6 +455,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
@@ -465,6 +522,17 @@
unit, for compatibility with SysV.
+
+ initrd-root-fs.target
+
+ systemd automatically
+ adds dependencies of type
+ Before to the sysroot.mount unit,
+ which is generated from the kernel command
+ line by the systemd-fstab-generator.
+
+
+ rpcbind.target
@@ -474,62 +542,27 @@
all SysV init script service
units with an LSB header
referring to the
- $rpcbind
+ $portmap
facility.
runlevel2.target
-
- This is a target that is
- called whenever 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 whenever 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 whenever 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 whenever the SysV
+ These are targets that
+ are called whenever the SysV
compatibility code asks for
- runlevel 5. It is a good idea
- to make this an alias for
+ runlevel 2, 3, 4, 5,
+ respectively. It is a good
+ idea to make this an alias for
(i.e. symlink to)
multi-user.target
- or
- graphical.target.
+ (for runlevel 2) or
+ graphical.target
+ (the others).
@@ -568,6 +601,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
@@ -582,6 +637,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
@@ -596,51 +670,39 @@
A special target unit
covering early boot-up scripts.
- 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.
-
-
-
- syslog.service
-
- The syslog service if
- any. Implementations should
- create a symlink from the
- actual syslog implementation
- to this generic name for
- activating it.syslog.socket
- The socket unit where
+ The socket unit
syslog implementations should
listen on. All userspace log
messages will be made
- available on this
- socket.
+ available on this socket. For
+ more information about syslog
+ integration, please consult
+ the Syslog
+ Interface
+ document.
- syslog.target
+ system-update.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
- $syslog
- facility.
+ 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.
@@ -674,6 +736,7 @@
is set (the default).
+
@@ -692,7 +755,7 @@
- exit.service
+ exit.targetA special service unit
for shutting down the
@@ -724,7 +787,9 @@
systemd.unit5,
systemd.service5,
systemd.socket5,
- systemd.target5
+ systemd.target5,
+ bootup7
+ systemd-fstab-generator8