X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.special.xml.in;h=afe882e51f231638b21eb5074ca374cb40a84b31;hb=2588ff0b940e82fd0986ed7567a6ae8f2741537d;hp=1d9c1326b4f2e5d43634f2eee69d54c2407c06a8;hpb=eeb7229cba8ef6445a9fc5ca2b0da06453d616af;p=elogind.git
diff --git a/man/systemd.special.xml.in b/man/systemd.special.xml.in
index 1d9c1326b..afe882e51 100644
--- a/man/systemd.special.xml.in
+++ b/man/systemd.special.xml.in
@@ -50,10 +50,11 @@
basic.target,
ctrl-alt-del.target,
- @SPECIAL_DBUS_SERVICE@,
+ dbus.service,
+ dbus.target,
default.target,
display-manager.service,
- emergency.service,
+ emergency.target,
exit.service,
graphical.target,
halt.target,
@@ -69,23 +70,22 @@
rescue.target,
rpcbind.target,
rtc-set.target,
- runlevel0.target,
- runlevel1.target,
runlevel2.target,
runlevel3.target,
runlevel4.target,
runlevel5.target,
- runlevel6.targetshutdown.target,
sigpwr.target,
sockets.target,
swap.target,
- syslog.target,
+ sysinit.target,
@SPECIAL_SYSLOG_SERVICE@,
+ syslog.target,
systemd-initctl.service,
systemd-initctl.socket,
systemd-logger.service,
- systemd-logger.socket
+ systemd-logger.socket,
+ umount.target
@@ -111,16 +111,15 @@
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.
+ Usually this should pull-in
+ all sockets, mount points,
+ swap devices and other basic
+ initialization necessary for
+ the general purpose
+ daemons. Most normal daemons
+ should have dependencies of
+ type After and Requires on
+ this unit.
@@ -136,7 +135,7 @@
- @SPECIAL_DBUS_SERVICE@
+ dbus.serviceA special unit for the
D-Bus system bus. As soon as
@@ -144,6 +143,28 @@
up systemd will connect to it
and register its
service.
+
+ Units should generally
+ avoid depending on this unit
+ directly and instead refer to
+ the
+ dbus.target
+ unit instead, which pulls this
+ one in directly or indirectly
+ via socket-based activation.
+
+
+
+ dbus.target
+
+ Administrators should
+ ensure that this target pulls
+ in a service unit with the
+ name or alias of
+ dbus.service
+ (or a socket unit that
+ activates this
+ service).
@@ -169,14 +190,14 @@
The display manager
service. Usually this should
be aliased (symlinked) to
- gdm.service
+ xdm.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 an LSB header
+ units with a LSB header
referring to the
$x-display-manager
facility, for compatibility
@@ -184,9 +205,9 @@
- emergency.service
+ emergency.target
- A special service unit
+ A special target unit
that starts an emergency
shell on the main
console. This unit is supposed
@@ -249,8 +270,8 @@
mounts listed in
/etc/fstab
that have the
- auto and
- comment=systemd.mount
+ and
+
mount options set.systemd automatically
@@ -268,7 +289,7 @@
The mail transfer agent
(MTA) service. Usually this
- should pull in all units
+ should pull-in all units
necessary for
sending/receiving mails on the
local host.
@@ -414,32 +435,6 @@
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
@@ -494,19 +489,6 @@
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
@@ -518,8 +500,10 @@
terminated on system shutdown
shall add Conflicts
dependencies to this unit for
- their service unit during
- installation.
+ their service unit, which is
+ implicitly done when
+ DefaultDependencies=yes
+ is set (the default).
systemd automatically
adds dependencies of type
@@ -564,6 +548,44 @@
files.
+
+ sysinit.target
+
+ 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.
+
+
+
+ @SPECIAL_SYSLOG_SERVICE@
+
+ A special unit for the
+ syslog daemon. As soon as
+ this service is fully started
+ up systemd will connect to it
+ and use it for logging if it
+ has been configured for
+ that.
+
+ Units should generally
+ avoid depending on this unit
+ directly and instead refer to
+ the
+ syslog.target
+ unit instead, which pulls this
+ one in directly or indirectly
+ via socket-based activation.
+
+ syslog.target
@@ -586,23 +608,6 @@
service).
-
- @SPECIAL_SYSLOG_SERVICE@
-
- A special unit for the
- syslog daemon. As soon as
- this service is fully started
- up systemd will connect to it
- and use it for logging if it
- has been configured for
- that.
- Applications should
- generally not depend on this
- service, and depend on
- syslog.target
- instead.
-
- systemd-initctl.service
@@ -651,13 +656,51 @@
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
+
+ Socket activation unit
+ for
+ system-shutdownd.service.
+
+
+
+ umount.target
+
+ A special target unit
+ that umounts all mount and
+ automount points on system
+ shutdown.
+
+ Mounts that shall be
+ unmounted on system shutdown
+ shall add Conflicts
+ dependencies to this unit for
+ their mount unit, which is
+ implicitly done when
+ DefaultDependencies=yes
+ is set (the default).
+
+
- Special Session Units
+ Special User Units
- When systemd runs as a service instance, the
+ When systemd runs as a user instance, the
following special units are available, which have
similar definitions as their system counterparts:
default.target,
@@ -676,22 +719,22 @@
A special service unit
for shutting down the
- session.
+ user service manager.Applications wanting to
- terminate the session should
- start this unit. If systemd
- receives SIGTERM or SIGINT
- when running as session daemon
- it will start this
- unit.
+ terminate the user service
+ manager should start this
+ unit. If systemd receives
+ SIGTERM or SIGINT when running
+ as user service daemon it will
+ start this unit.Normally, this pulls in
shutdown.target
which in turn should be
conflicted by all units that
want to be shut down on
- session exit.
+ user service manager exit.
@@ -700,9 +743,9 @@
See Also
- systemd.unit5
- systemd.service5
- systemd.socket5
+ systemd.unit5,
+ systemd.service5,
+ systemd.socket5,
systemd.target5