X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.special.xml;h=67a81b639b8d115df3700324f969c3bb550f05ee;hp=fe85137ffe33f15bf5de84bd1aa9403172a54b6e;hb=9e5f0f92915b777308797294c6e103e430957b5d;hpb=6df831f25ebc9f55cd939f04392dad9237706e45 diff --git a/man/systemd.special.xml b/man/systemd.special.xml index fe85137ff..67a81b639 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 . --> @@ -49,30 +49,37 @@ basic.target, + bluetooth.target, ctrl-alt-del.target, + cryptsetup.target, dbus.service, dbus.socket, default.target, display-manager.service, emergency.target, - exit.service, - final.service, + exit.target, + final.target, + getty.target, graphical.target, - http-daemon.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, + initrd-root-fs.target, rpcbind.target, runlevel2.target, runlevel3.target, @@ -80,12 +87,15 @@ runlevel5.target, shutdown.target, sigpwr.target, + sleep.target, + smartcard.target, sockets.target, + sound.target, + suspend.target, swap.target, sysinit.target, - syslog.service, syslog.socket, - syslog.target, + system-update.target, time-sync.target, umount.target @@ -124,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 @@ -136,6 +156,15 @@ reboot.target. + + cryptsetup.target + + A target that pulls in + setup services for all + encrypted block + devices. + + dbus.service @@ -185,15 +214,6 @@ 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. @@ -223,6 +243,15 @@ + + getty.target + + A special target unit + that pulls in all local TTY + getty instances. + + + graphical.target @@ -240,19 +269,21 @@ - http-daemon.target + hibernate.target - A target for pulling in - an HTTP server if there is - any. - 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 - $httpd - facility. + 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. @@ -266,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 @@ -305,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. @@ -328,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 @@ -378,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 @@ -408,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 @@ -465,6 +522,17 @@ unit, for compatibility with SysV. + + initrd-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 @@ -474,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). @@ -568,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 @@ -582,6 +637,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 @@ -596,51 +670,39 @@ 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.service - - The syslog service if - any. Implementations should - create a symlink from the - actual syslog implementation - to this generic name for - activating it. syslog.socket - The socket unit where + The socket unit syslog implementations should listen on. All userspace log messages will be made - available on this - socket. + available on this socket. For + more information about syslog + integration, please consult + the Syslog + Interface + document. - syslog.target + system-update.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. + 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. @@ -674,6 +736,7 @@ is set (the default). + @@ -692,7 +755,7 @@ - exit.service + exit.target A special service unit for shutting down the @@ -724,7 +787,9 @@ systemd.unit5, systemd.service5, systemd.socket5, - systemd.target5 + systemd.target5, + bootup7 + systemd-fstab-generator8