From bd3d19a4ea3b007bea4c94213cafd5dc37ce7a3d Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Mon, 17 May 2010 19:37:21 +0200 Subject: [PATCH] man: complete service.special(7) man page --- man/systemd.special.xml | 373 +++++++++++++++++++++++++++++++++++----- 1 file changed, 326 insertions(+), 47 deletions(-) diff --git a/man/systemd.special.xml b/man/systemd.special.xml index 3f9286d4b..e81e99e44 100644 --- a/man/systemd.special.xml +++ b/man/systemd.special.xml @@ -48,22 +48,38 @@ + basic.target + ctrl-alt-del.target + default.target emergency.service + graphical.target + halt.target + kbrequest.target local-fs.target + multi-user.target network.target nss-lookup.target + poweroff.target + reboot.target remote-fs.target + rescue.target rpcbind.target rtc-set.target + runlevel0.target, + runlevel0.target, + runlevel1.target, + runlevel2.target, + runlevel3.target, + runlevel4.target, + runlevel5.target, + runlevel6.target shutdown.target sigpwr.target sockets.target swap.target syslog.target - systemd-initctl.service - systemd-initctl.socket - systemd-logger.service - systemd-logger.socket + systemd-initctl.service, systemd-initctl.socket + systemd-logger.service, systemd-logger.socket @@ -78,6 +94,58 @@ Special System Units + + basic.target + + A special target unit + covering early 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. + 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. + + + + ctrl-alt-del.target + + systemd starts this + target whenever + Control+Alt+Del is pressed on + the console. Usually this + should be aliased (symlinked) + to + reboot.target. + + + + default.target + + The default unit systemd + starts at bootup. Usually this + should be aliased (symlinked) + to + multi-user.target + or + graphical.target. + The default unit systemd + starts at bootup can be + overriden with the + systemd.default= + kernel command line option. + + emergency.service @@ -92,17 +160,56 @@ + + graphical.target + + A special target unit + for setting up a graphical + login screen. This pulls in + multi-user.target. + + Units that are needed + for graphical login shall add + Wants dependencies for their + unit to this unit (or + multi-user.target) + during installation. + + + + halt.target + + A special target unit + for shutting down and halting the system. + + Applications wanting to + halt the system should start + this unit. + + + + kbrequest.target + + systemd starts this + target whenever Alt+ArrowUp is + pressed on the console. This + is a good candidate to be + aliased (symlinked) to + rescue.target. + + local-fs.target systemd automatically adds dependencies of type After to all mount units that - refer to local mount - points. In addition, systemd - adds dependencies of type - Wants to those mounts listed - in + refer to local mount points + for this target unit. In + addition, systemd adds + dependencies of type Wants to + this target unit for those + mounts listed in /etc/fstab that have the auto and @@ -111,21 +218,39 @@ systemd automatically adds dependencies of type - After to this target unit for - all SysV init scripts 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 $local_fs facility. + + multi-user.target + + A special target unit + for setting up a multi-user + system (non-graphical). This + is pulled in by + graphical.target. + + Units that are needed + for a multi-user system shall + add Wants dependencies to + this unit for their unit during + installation. + + network.target systemd automatically adds dependencies of type - After to this target unit for - all SysV init scripts 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. @@ -135,34 +260,83 @@ systemd automatically adds dependencies of type - After to this target unit for - all SysV init scripts 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 $named facility. + + poweroff.target + + A special target unit + for shutting down and powering off the system. + + Applications wanting to + power off the system should start + this unit. + + runlevel0.target + is an alias for this target + unit, for compatibility with SysV. + + + + reboot.target + + A special target unit + for shutting down and rebooting the system. + + Applications wanting to + reboot the system should start + this unit. + + runlevel6.target + is an alias for this target + unit, for compatibility with SysV. + + remote-fs.target - Similar to local-fs.target, but for remote mount points. + Similar to + local-fs.target, + but for remote mount + points. + systemd automatically adds dependencies of type - After to this target unit for - all SysV init scripts 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. + + rescue.target + + A special target unit + for setting up the base system + and a rescue shell. + + runlevel1.target + is an alias for this target + unit, for compatibility with SysV. + + rpcbind.target systemd automatically adds dependencies of type - After to this target unit for - all SysV init scripts 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 $rpcbind facility. @@ -172,13 +346,107 @@ systemd automatically adds dependencies of type - After to this target unit for - all SysV init scripts 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. + + 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 + 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 whever 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 whever 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 whever the SysV + compatibility code asks for + runlevel 5. It is a good idea + to make this an alias for + (i.e. symlink to) + multi-user.target + or + 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 @@ -188,17 +456,18 @@ Services that shall be terminated on system shutdown - shall add Wants dependencies - from this unit to their - service unit during + shall add Conflicts + dependencies to this unit for + their service unit during installation. systemd automatically adds dependencies of type Conflicts to this target unit - for all SysV init scripts that - shall be terminated in SysV - runlevels 0 or 6. + for all SysV init script + service units that shall be + terminated in SysV runlevels 0 + or 6. @@ -208,7 +477,7 @@ started when systemd receives the SIGPWR process signal, which is normally sent by the - kernel or UPS daemons when the + kernel or UPS daemons when power fails. @@ -221,8 +490,8 @@ Services that can be socket-activated shall add - Wants dependencies from this - unit to their socket unit + Wants dependencies to this + unit for their socket unit during installation. @@ -240,9 +509,10 @@ systemd automatically adds dependencies of type - After to this target unit for - all SysV init scripts 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 $syslog facility. @@ -250,9 +520,10 @@ ensure that this target pulls in a service unit with the name or alias of - @SPECIAL_SYSLOG_NAME@ (or a - socket unit that activates - this service). + @SPECIAL_SYSLOG_SERVICE@ + (or a socket unit that + activates this + service). @@ -279,10 +550,10 @@ systemd-logger.service - This is used internally + This is internally used by systemd to provide syslog - logging to started - processes. + logging to the processes it + maintains. This is a socket-activated service, see system-logger.socket. @@ -293,7 +564,14 @@ Socket activation unit for - system-logger.service. + system-logger.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. @@ -305,6 +583,7 @@ When systemd runs as a service instance, the following special units are available, which have similar definitions as their system counterparts: + default.target, local-fs.target, remote-fs.target, shutdown.target, -- 2.30.2