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=ecc9ddee6af1848d6f7e92c50413c47a0a642222;hp=da474b74773291c1f7a501ea0a5a51d480fd6ee2;hb=b4f78aeac66e64e0489d7a26f1370a69d0fcf011;hpb=9f2c5942e1e10099027f0da438aafdd9f40440ba diff --git a/man/systemd.special.xml.in b/man/systemd.special.xml.in index da474b747..ecc9ddee6 100644 --- a/man/systemd.special.xml.in +++ b/man/systemd.special.xml.in @@ -50,12 +50,16 @@ basic.target, ctrl-alt-del.target, + dbus.service, default.target, - emergency.service, + display-manager.service, + emergency.target, + exit.service, graphical.target, halt.target, kbrequest.target, local-fs.target, + mail-transfer-agent.target, multi-user.target, network.target, nss-lookup.target, @@ -64,23 +68,22 @@ remote-fs.target, rescue.target, rpcbind.target, - rtc-set.target, - runlevel0.target, - runlevel1.target, + time-sync.target, runlevel2.target, runlevel3.target, runlevel4.target, runlevel5.target, - runlevel6.target shutdown.target, sigpwr.target, sockets.target, swap.target, + sysinit.target, syslog.target, systemd-initctl.service, systemd-initctl.socket, systemd-logger.service, - systemd-logger.socket + systemd-logger.socket, + umount.target @@ -106,16 +109,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. @@ -130,6 +132,17 @@ reboot.target. + + dbus.service + + A special unit for the + D-Bus system bus. As soon as + this service is fully started + up systemd will connect to it + and register its + service. + + default.target @@ -142,21 +155,41 @@ graphical.target. The default unit systemd starts at bootup can be - overriden with the - systemd.default= + overridden with the + systemd.unit= kernel command line option. - emergency.service + display-manager.service - A special service unit + The display manager + service. Usually this should + be aliased (symlinked) to + 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 a LSB header + referring to the + $x-display-manager + facility, for compatibility + with Debian. + + + + emergency.target + + A special target unit that starts an emergency shell on the main console. This unit is supposed to be used with the kernel command line option - systemd.default= + systemd.unit= and has otherwise little use. @@ -213,8 +246,8 @@ mounts listed in /etc/fstab that have the - auto and - comment=systemd.mount + and + mount options set. systemd automatically @@ -227,6 +260,29 @@ facility. + + 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 @@ -313,7 +369,7 @@ all SysV init script service units with an LSB header referring to the - $remote-fs + $remote_fs facility. @@ -343,7 +399,7 @@ - rtc-set.target + time-sync.target systemd automatically adds dependencies of type @@ -355,37 +411,11 @@ 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 + called whenever the SysV compatibility code asks for runlevel 2. It is a good idea to make this an alias for @@ -397,7 +427,7 @@ runlevel3.target This is a target that is - called whever the SysV + called whenever the SysV compatibility code asks for runlevel 3. It is a good idea to make this an alias for @@ -411,7 +441,7 @@ runlevel4.target This is a target that is - called whever the SysV + called whenever the SysV compatibility code asks for runlevel 4. It is a good idea to make this an alias for @@ -425,7 +455,7 @@ runlevel5.target This is a target that is - called whever the SysV + called whenever the SysV compatibility code asks for runlevel 5. It is a good idea to make this an alias for @@ -435,19 +465,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 @@ -459,8 +476,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 @@ -505,6 +524,23 @@ 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. + + syslog.target @@ -516,15 +552,6 @@ referring to the $syslog facility. - - Administrators should - ensure that this target pulls - in a service unit with the - name or alias of - @SPECIAL_SYSLOG_SERVICE@ - (or a socket unit that - activates this - service). @@ -575,13 +602,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, @@ -590,14 +655,43 @@ shutdown.target, sockets.target, swap.target. + + In addition the following special unit is + understood only when systemd runs as service instance: + + + + exit.service + + A special service unit + for shutting down the + user service manager. + + Applications wanting to + 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 + user service manager exit. + + + See Also - systemd.unit5 - systemd.service5 - systemd.socket5 + systemd.unit5, + systemd.service5, + systemd.socket5, systemd.target5