X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.special.xml;h=7b780998fd22fdd3353d56d6fbbeb9c5121d467b;hp=116a43ccfb30798e6570fdeb43df6ac2963c962c;hb=700e07ffd53083114e91bb4ba646ed26d0463f67;hpb=19c5f19d69bb5f520fa7213239490c55de06d99d diff --git a/man/systemd.special.xml b/man/systemd.special.xml index 116a43ccf..7b780998f 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,31 +44,42 @@ 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, + initrd-fs.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, rescue.target, + root-fs.target, rpcbind.target, runlevel2.target, runlevel3.target, @@ -76,14 +87,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 +134,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 +156,15 @@ reboot.target. + + cryptsetup.target + + A target that pulls in + setup services for all + encrypted block + devices. + + dbus.service @@ -145,6 +176,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 +211,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 +230,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 +268,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 @@ -223,6 +297,22 @@ this unit. + + initrd-fs.target + + systemd automatically + adds dependencies of type + Before to sysroot-usr.mount and + all mount points fround in + /etc/fstab + that have the + and + + mount options set. + See also systemd-fstab-generator. + + + kbrequest.target @@ -234,6 +324,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 +352,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 +366,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 +393,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 +455,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 @@ -411,6 +522,17 @@ unit, for compatibility with SysV. + + root-fs.target + + systemd automatically + adds dependencies of type + Before to the sysroot.mount unit, + which is generated from the kernel command + line by the systemd-fstab-generator. + + + rpcbind.target @@ -420,62 +542,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 +601,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 @@ -529,110 +638,71 @@ - swap.target + sound.target - Similar to - local-fs.target, but for swap - partitions and swap - files. + This target is started + automatically as soon as a + sound card is plugged in or + becomes available at + boot. - sysinit.target + suspend.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 - - 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 - - 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. + for suspending the + system. This pulls in + sleep.target. - systemd-initctl.socket + swap.target - Socket activation unit - for - system-initctl.service. + Similar to + local-fs.target, but for swap + partitions and swap + files. - systemd-stdout-syslog-bridge.service + sysinit.target - 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. + A special target unit + covering early boot-up scripts. - 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 + syslog.socket - This is internally used - by - shutdown8 - to implement delayed shutdowns. - This is a - socket-activated service, see - system-shutdownd.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-shutdownd.socket + system-update.target - 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 +736,7 @@ is set (the default). + @@ -676,18 +747,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 +783,13 @@ See Also + systemd1, systemd.unit5, systemd.service5, systemd.socket5, - systemd.target5 + systemd.target5, + bootup7 + systemd-fstab-generator8