X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.special.xml;h=6acba91428f8dd719af5da266e6873c644df81a4;hp=116a43ccfb30798e6570fdeb43df6ac2963c962c;hb=64abe9aa3f7dc7d755a4d3d1783fe3f0285edaea;hpb=19c5f19d69bb5f520fa7213239490c55de06d99d diff --git a/man/systemd.special.xml b/man/systemd.special.xml index 116a43ccf..6acba9142 100644 --- a/man/systemd.special.xml +++ b/man/systemd.special.xml @@ -8,16 +8,16 @@ Copyright 2010 Lennart Poettering systemd is free software; you can redistribute it and/or modify it - under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or + under the terms of the GNU Lesser General Public License as published by + the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. systemd is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. + Lesser General Public License for more details. - You should have received a copy of the GNU General Public License + You should have received a copy of the GNU Lesser General Public License along with systemd; If not, see . --> @@ -44,27 +44,36 @@ systemd.special - special systemd units + Special systemd units basic.target, + bluetooth.target, ctrl-alt-del.target, + cryptsetup.target, dbus.service, + dbus.socket, default.target, display-manager.service, emergency.target, - exit.service, + exit.target, + final.target, + getty.target, graphical.target, halt.target, + hibernate.target, + hybrid-sleep.target, kbrequest.target, + kexec.target, local-fs.target, local-fs-pre.target, - mail-transfer-agent.target, multi-user.target, network.target, nss-lookup.target, + nss-user-lookup.target, poweroff.target, + printer.target, reboot.target, remote-fs.target, remote-fs-pre.target, @@ -76,14 +85,15 @@ runlevel5.target, shutdown.target, sigpwr.target, + sleep.target, + smartcard.target, sockets.target, + sound.target, + suspend.target, swap.target, sysinit.target, - syslog.target, - systemd-initctl.service, - systemd-initctl.socket, - systemd-stdout-syslog-bridge.service, - systemd-stdout-syslog-bridge.socket, + syslog.socket, + system-update.target, time-sync.target, umount.target @@ -122,6 +132,16 @@ this unit. + + bluetooth.target + + This target is started + automatically as soon as a + bluetooth controller is + plugged in or becomes + available at boot. + + ctrl-alt-del.target @@ -134,6 +154,15 @@ reboot.target. + + cryptsetup.target + + A target that pulls in + setup services for all + encrypted block + devices. + + dbus.service @@ -145,6 +174,18 @@ service. + + dbus.socket + + A special unit for the + D-Bus system bus socket. All + units with + Type=dbus + automatically gain a + dependency on this + unit. + + default.target @@ -168,18 +209,9 @@ The display manager service. Usually this should be aliased (symlinked) to - xdm.service + gdm.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. @@ -196,6 +228,28 @@ + + final.target + + A special target unit + that is used during the + shutdown logic and may be used + to pull in late services after + all normal services are + already terminated and all + mounts unmounted. + + + + + getty.target + + A special target unit + that pulls in all local TTY + getty instances. + + + graphical.target @@ -212,6 +266,24 @@ during installation. + + hibernate.target + + A special target unit + for hibernating the + system. This pulls in + sleep.target. + + + + hybrid-sleep.target + + A special target unit + for hibernating and suspending the + system at the same time. This pulls in + sleep.target. + + halt.target @@ -234,6 +306,17 @@ rescue.target. + + kexec.target + + A special target unit + for shutting down and rebooting the system via kexec. + + Applications wanting to + reboot the system with kexec should start + this unit. + + local-fs.target @@ -251,15 +334,6 @@ and mount options set. - - 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 - $local_fs - facility. @@ -274,29 +348,6 @@ all local mounts. - - 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 @@ -324,21 +375,53 @@ referring to the $network facility. + + This unit is supposed to + indicate when the network is + "up", but it is only very + loosely defined what that is + supposed to mean. Also see Running + Services After the Network is + up for more + information. nss-lookup.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 + A target that should be + used as synchronization point + for all host/network name + service lookups. Note that + this is independent of + user/group name lookups for + which + nss-user-lookup.target + should be used. 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 $named facility. + + nss-user-lookup.target + + A target that should be + used as synchronization point + for all user/group name + service lookups. Note that + this is independent of + host/network name lookups for + which + nss-lookup.target + should be used. + + poweroff.target @@ -354,6 +437,16 @@ unit, for compatibility with SysV. + + printer.target + + This target is started + automatically as soon as a + printer is plugged in or + becomes available at + boot. + + reboot.target @@ -420,62 +513,27 @@ all SysV init script service units with an LSB header referring to the - $rpcbind + $portmap facility. runlevel2.target - - This is a target that is - called whenever the SysV - compatibility code asks for - runlevel 2. It is a good idea - to make this an alias for - (i.e. symlink to) - multi-user.target. - - - runlevel3.target - - This is a target that is - called whenever the SysV - compatibility code asks for - runlevel 3. It is a good idea - to make this an alias for - (i.e. symlink to) - multi-user.target - or - graphical.target. - - - runlevel4.target - - This is a target that is - called whenever the SysV - compatibility code asks for - runlevel 4. It is a good idea - to make this an alias for - (i.e. symlink to) - multi-user.target - or - graphical.target. - - - runlevel5.target - This is a target that is - called whenever the SysV + These are targets that + are called whenever the SysV compatibility code asks for - runlevel 5. It is a good idea - to make this an alias for + runlevel 2, 3, 4, 5, + respectively. It is a good + idea to make this an alias for (i.e. symlink to) multi-user.target - or - graphical.target. + (for runlevel 2) or + graphical.target + (the others). @@ -514,6 +572,28 @@ power fails. + + sleep.target + + A special target unit + that is pulled in by + suspend.target, + hibernate.target and hybrid-sleep.target + and may be used to hook units + into the sleep state + logic. + + + + smartcard.target + + This target is started + automatically as soon as a + smartcard controller is + plugged in or becomes + available at boot. + + sockets.target @@ -528,6 +608,25 @@ during installation. + + sound.target + + This target is started + automatically as soon as a + sound card is plugged in or + becomes available at + boot. + + + + suspend.target + + A special target unit + for suspending the + system. This pulls in + sleep.target. + + swap.target @@ -555,84 +654,36 @@ - 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. - - - - systemd-initctl.service + syslog.socket - This provides - compatibility with the SysV - /dev/initctl file system FIFO - for communication with the - init system. - This is a - socket-activated service, see - system-initctl.socket. + The socket unit + syslog implementations should + listen on. All userspace log + messages will be made + available on this socket. For + more information about syslog + integration, please consult + the Syslog + Interface + document. - systemd-initctl.socket + system-update.target - Socket activation unit - for - system-initctl.service. - - - - systemd-stdout-syslog-bridge.service - - This is internally used - by systemd to provide syslog - logging to the processes it - maintains. - This is a - socket-activated service, see - system-stdout-syslog-bridge.socket. - - - - systemd-stdout-syslog-bridge.socket - - Socket activation unit - for - system-stdout-syslog-bridge.service. systemd - will automatically add - dependencies of types Requires - and After to all units that - have been configured for - stdout or stderr to be - connected to syslog or the - 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. + A special target unit + that is used for off-line + system updates. + systemd-system-update-generator8 + will redirect the boot process + to this target if + /system-update + exists. For more information + see the System + Updates + Specification. @@ -666,6 +717,7 @@ is set (the default). + @@ -676,18 +728,15 @@ following special units are available, which have similar definitions as their system counterparts: default.target, - local-fs.target, - remote-fs.target, shutdown.target, - sockets.target, - swap.target. + sockets.target In addition the following special unit is understood only when systemd runs as service instance: - exit.service + exit.target A special service unit for shutting down the @@ -715,10 +764,12 @@ See Also + systemd1, systemd.unit5, systemd.service5, systemd.socket5, - systemd.target5 + systemd.target5, + bootup7