X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.special.xml;h=8a7242662d7ac6c94958e2266803f05464849b18;hb=e3d84721dc9bcf9008f72dae03ff0f7842d0bb4b;hp=6b8e0ec7f0b8fe7cedc9a95ada2622a690dc0940;hpb=6524990fdc98370ecba5d9f73e67161e8798c010;p=elogind.git diff --git a/man/systemd.special.xml b/man/systemd.special.xml index 6b8e0ec7f..8a7242662 100644 --- a/man/systemd.special.xml +++ b/man/systemd.special.xml @@ -61,25 +61,26 @@ final.target, getty.target, graphical.target, + halt.target, hibernate.target, - http-daemon.target, hybrid-sleep.target, - halt.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, + paths.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, @@ -95,9 +96,9 @@ swap.target, sysinit.target, syslog.socket, - syslog.target, system-update.target, time-sync.target, + timers.target, umount.target @@ -117,22 +118,23 @@ basic.target A special target unit - covering early boot-up. + covering basic boot-up. systemd automatically adds dependencies of the types - Requires and After for this - target unit to all SysV - service units configured for - runlevel 1 to 5. - Usually this should pull-in - all sockets, mount points, - swap devices and other basic + Requires= + and After= + for this target unit to all + services (except for those + with + DefaultDependencies=no). + + Usually this should + pull-in all mount points, swap + devices, sockets, timers, and + path units and other basic initialization necessary for - the general purpose - daemons. Most normal daemons - should have dependencies of - type After and Requires on - this unit. + general purpose + daemons. @@ -140,9 +142,15 @@ This target is started automatically as soon as a - bluetooth controller is + Bluetooth controller is plugged in or becomes available at boot. + + This may be used to pull + in Bluetooth management + daemons dynamically when + Bluetooth hardware is + found. @@ -170,7 +178,7 @@ dbus.service A special unit for the - D-Bus system bus. As soon as + D-Bus bus daemon. As soon as this service is fully started up systemd will connect to it and register its @@ -183,7 +191,7 @@ A special unit for the D-Bus system bus socket. All units with - Type=dbus + Type=dbus automatically gain a dependency on this unit. @@ -199,6 +207,7 @@ multi-user.target or graphical.target. + The default unit systemd starts at bootup can be overridden with the @@ -215,15 +224,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. @@ -257,8 +257,10 @@ getty.target A special target unit - that pulls in all local TTY - getty instances. + that pulls in statically + configured local TTY + getty + instances. @@ -271,11 +273,17 @@ multi-user.target. Units that are needed - for graphical login shall add - Wants dependencies for their - unit to this unit (or + for graphical logins shall add + Wants= + dependencies for their unit to + this unit (or multi-user.target) - during installation. + during installation. This is + best configured via + WantedBy=graphical.target + in the unit's + [Install] + section. @@ -287,22 +295,6 @@ sleep.target. - - http-daemon.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. - - hybrid-sleep.target @@ -316,13 +308,36 @@ halt.target A special target unit - for shutting down and halting the system. + for shutting down and halting + the system. Note that this + target is distinct from + poweroff.target + in that it generally really + just halts the system rather + than powering it down. Applications wanting to halt the system should start this unit. + + initrd-fs.target + + systemd-fstab-generator3 + 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. + + + kbrequest.target @@ -348,29 +363,21 @@ local-fs.target - systemd automatically + systemd-fstab-generator3 + automatically adds + dependencies of type + Before= to + all mount units that refer to + local mount points for this + target unit. In addition, it adds dependencies of type - After to all mount units that - refer to local mount points - for this target unit. In - addition, systemd adds - dependencies of type Wants to + Wants= to this target unit for those mounts listed in /etc/fstab that have the - 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. + mount + option set. @@ -385,29 +392,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 @@ -419,9 +403,15 @@ Units that are needed for a multi-user system shall - add Wants dependencies to - this unit for their unit during - installation. + add Wants= + dependencies for their unit to + this unit during + installation. This is best + configured via + WantedBy=multi-uer.target + in the unit's + [Install] + section. @@ -429,12 +419,22 @@ 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 + After= for + this target unit to all SysV + init script service units with + an LSB header 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. @@ -450,7 +450,8 @@ nss-user-lookup.target should be used. systemd automatically adds - dependencies of type After for + dependencies of type + After= for this target unit to all SysV init script service units with an LSB header referring to the @@ -472,6 +473,29 @@ should be used. + + paths.target + + A special target unit + that sets up all path units + (see + systemd.path5 + for details) that shall be + active after boot. + + It is recommended that + path units installed by + applications get pulled in via + Wants= + dependencies from this + unit. This is best configured + via a + WantedBy=paths.target + in the path unit's + [Install] + section. + + poweroff.target @@ -495,6 +519,12 @@ printer is plugged in or becomes available at boot. + + This may be used to pull + in printer management + daemons dynamically when + printer hardware is + found. @@ -522,10 +552,10 @@ 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 + After= for + this target unit to all SysV + init script service units with + an LSB header referring to the $remote_fs facility. @@ -554,71 +584,50 @@ unit, for compatibility with SysV. + + initrd-root-fs.target + + systemd-fstab-generator3 + automatically adds + dependencies of type + Before= to + the + sysroot.mount + unit, which is generated from + the kernel command line. + + + rpcbind.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 + After= for + this target unit to all SysV + init script service units with + an LSB header referring to the $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). @@ -630,20 +639,12 @@ Services that shall be terminated on system shutdown - shall add Conflicts + shall add Conflicts= dependencies to this unit for their service unit, which is implicitly done when DefaultDependencies=yes is set (the default). - - systemd automatically - adds dependencies of type - Conflicts to this target unit - for all SysV init script - service units that shall be - terminated in SysV runlevels 0 - or 6. @@ -663,7 +664,9 @@ A special target unit that is pulled in by suspend.target, - hibernate.target and hybrid-sleep.target + hibernate.target + and + hybrid-sleep.target and may be used to hook units into the sleep state logic. @@ -677,20 +680,35 @@ smartcard controller is plugged in or becomes available at boot. + + This may be used to pull + in printer management + daemons dynamically when + smartcard hardware is + found. sockets.target A special target unit - that sets up all service - sockets. + that sets up all socket + units.(see + systemd.socket5 + for details) that shall be + active after boot. Services that can be socket-activated shall add - Wants dependencies to this - unit for their socket unit - during installation. + Wants= + dependencies to this unit for + their socket unit during + installation. This is best + configured via a + WantedBy=sockets.target + in the socket unit's + [Install] + section. @@ -701,6 +719,11 @@ sound card is plugged in or becomes available at boot. + + This may be used to pull + in audio management daemons + dynamically when printer + hardware is found. @@ -726,22 +749,12 @@ 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.socket - The socket unit where + The socket unit syslog implementations should listen on. All userspace log messages will be made @@ -754,19 +767,6 @@ document. - - 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. - - system-update.target @@ -789,14 +789,37 @@ 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 + After= for + this target unit to all SysV + init script service units with + an LSB header referring to the $time facility. + + timers.target + + A special target unit + that sets up all timer + units (see + systemd.timer5 + for details) that shall be + active after boot. + + It is recommended that + timer units installed by + applications get pulled in via + Wants= + dependencies from this + unit. This is best configured + via + WantedBy=timers.target + in the timer unit's + [Install] + section. + + umount.target @@ -867,7 +890,8 @@ systemd.service5, systemd.socket5, systemd.target5, - bootup7 + bootup7, + systemd-fstab-generator8