X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.special.xml.in;h=c6c2393fc3b4121b7204507e27d515c1f57c2c81;hp=1d9c1326b4f2e5d43634f2eee69d54c2407c06a8;hb=3059b1c1f414300332320f286bb458531394f0b0;hpb=eeb7229cba8ef6445a9fc5ca2b0da06453d616af diff --git a/man/systemd.special.xml.in b/man/systemd.special.xml.in index 1d9c1326b..c6c2393fc 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.target shutdown.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.service A 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,6 +656,24 @@ kernel log buffer. + + 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). + +