X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.special.xml.in;h=49dc3892c0c4bc67c8e4a41cf9b6d85f82b49477;hp=daa93583f573bd5fd1669fed11a8ea7ec61e5c8b;hb=37967211b336e134d3984a6710e39a549ed904e3;hpb=1e89ced119b1b80d21fca778fb20eb818b6f20c5 diff --git a/man/systemd.special.xml.in b/man/systemd.special.xml.in index daa93583f..49dc3892c 100644 --- a/man/systemd.special.xml.in +++ b/man/systemd.special.xml.in @@ -50,12 +50,17 @@ basic.target, ctrl-alt-del.target, + @SPECIAL_DBUS_SERVICE@, + dbus.target, default.target, + display-manager.service, emergency.service, + exit.service, graphical.target, halt.target, kbrequest.target, local-fs.target, + mail-transfer-agent.target, multi-user.target, network.target, nss-lookup.target, @@ -65,17 +70,16 @@ 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, + sysinit.target, + @SPECIAL_SYSLOG_SERVICE@, syslog.target, systemd-initctl.service, systemd-initctl.socket, @@ -106,16 +110,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 +133,39 @@ reboot.target. + + @SPECIAL_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. + + 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 + @SPECIAL_DBUS_SERVICE@ + (or a socket unit that + activates this + service). + + default.target @@ -147,6 +183,26 @@ kernel command line option. + + display-manager.service + + 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.service @@ -213,8 +269,8 @@ mounts listed in /etc/fstab that have the - auto and - comment=systemd.mount + and + mount options set. systemd automatically @@ -227,6 +283,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-argent + or + $mail-transport-agent + facilities, for compatibility + with Debian. + + multi-user.target @@ -355,32 +434,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 @@ -435,19 +488,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 @@ -505,6 +545,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 @@ -590,6 +668,35 @@ 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 + session. + + 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. + + Normally, this pulls in + shutdown.target + which in turn should be + conflicted by all units that + want to be shut down on + session exit. + + +