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=116a43ccfb30798e6570fdeb43df6ac2963c962c;hp=a2e1bb2cbd594c06a46e446739e4296202b64448;hb=e92238567b9fc83ef77e359588d7b005ecae3d70;hpb=f92a18f5274ad506aed600b2ed8f4a560c510807 diff --git a/man/systemd.special.xml.in b/man/systemd.special.xml.in index a2e1bb2cb..116a43ccf 100644 --- a/man/systemd.special.xml.in +++ b/man/systemd.special.xml.in @@ -50,15 +50,16 @@ basic.target, ctrl-alt-del.target, - @SPECIAL_DBUS_SERVICE@, + dbus.service, default.target, display-manager.service, - emergency.service, + emergency.target, exit.service, graphical.target, halt.target, kbrequest.target, local-fs.target, + local-fs-pre.target, mail-transfer-agent.target, multi-user.target, network.target, @@ -66,27 +67,25 @@ poweroff.target, reboot.target, remote-fs.target, + remote-fs-pre.target, 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, syslog.target, - @SPECIAL_SYSLOG_SERVICE@, systemd-initctl.service, systemd-initctl.socket, - systemd-logger.service, - systemd-logger.socket + systemd-stdout-syslog-bridge.service, + systemd-stdout-syslog-bridge.socket, + time-sync.target, + umount.target @@ -112,12 +111,12 @@ target unit to all SysV service units configured for runlevel 1 to 5. - Usually this should pull - in all sockets, mount points, + Usually this should pull-in + all sockets, mount points, swap devices and other basic initialization necessary for the general purpose - daemons. Most normal daemon + 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 @@ -158,8 +157,8 @@ 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. @@ -169,14 +168,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,15 +183,15 @@ - 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 to be used with the kernel command line option - systemd.default= + systemd.unit= and has otherwise little use. @@ -249,8 +248,8 @@ mounts listed in /etc/fstab that have the - auto and - comment=systemd.mount + and + mount options set. systemd automatically @@ -263,12 +262,24 @@ facility. + + local-fs-pre.target + + This target unit is + automatically ordered before + all local mount points marked + with + (see above). It can be used to + execute certain units before + all local mounts. + + mail-transfer-agent.target 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. @@ -279,7 +290,7 @@ all SysV init script service units with an LSB header referring to the - $mail-transfer-argent + $mail-transfer-agent or $mail-transport-agent facilities, for compatibility @@ -376,6 +387,18 @@ facility. + + remote-fs-pre.target + + This target unit is + automatically ordered before + all remote mount points marked + with + (see above). It can be used to + execute certain units before + all remote mounts. + + rescue.target @@ -401,50 +424,11 @@ facility. - - rtc-set.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 - $time - 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 @@ -456,7 +440,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 @@ -470,7 +454,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 @@ -484,7 +468,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 @@ -494,19 +478,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 +489,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,28 +537,6 @@ files. - - syslog.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. - - 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). - - sysinit.target @@ -604,20 +555,16 @@ - @SPECIAL_SYSLOG_SERVICE@ + syslog.target - 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 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. @@ -642,7 +589,7 @@ - systemd-logger.service + systemd-stdout-syslog-bridge.service This is internally used by systemd to provide syslog @@ -650,15 +597,15 @@ maintains. This is a socket-activated service, see - system-logger.socket. + system-stdout-syslog-bridge.socket. - systemd-logger.socket + systemd-stdout-syslog-bridge.socket Socket activation unit for - system-logger.service. systemd + system-stdout-syslog-bridge.service. systemd will automatically add dependencies of types Requires and After to all units that @@ -668,13 +615,64 @@ 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. + + + + time-sync.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 + $time + facility. + + + + 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, @@ -693,22 +691,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. @@ -717,9 +715,9 @@ See Also - systemd.unit5 - systemd.service5 - systemd.socket5 + systemd.unit5, + systemd.service5, + systemd.socket5, systemd.target5