From 9f2c5942e1e10099027f0da438aafdd9f40440ba Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Mon, 17 May 2010 22:45:52 +0200 Subject: man: replace syslog name in man page by configured name --- man/systemd.special.xml.in | 605 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 605 insertions(+) create mode 100644 man/systemd.special.xml.in (limited to 'man/systemd.special.xml.in') diff --git a/man/systemd.special.xml.in b/man/systemd.special.xml.in new file mode 100644 index 0000000000..da474b7477 --- /dev/null +++ b/man/systemd.special.xml.in @@ -0,0 +1,605 @@ + + + + + + + + + systemd.special + systemd + + + + Developer + Lennart + Poettering + lennart@poettering.net + + + + + + systemd.special + 7 + + + + systemd.special + special systemd units + + + + 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, + 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 + + + + Description + + A few units are treated specially by + systemd. They have special internal semantics and + cannot be renamed. + + + + 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 + + A special service unit + that starts an emergency + shell on the main + console. This unit is supposed + to be used with the kernel + command line option + systemd.default= + and has otherwise little use. + + + + + 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 + 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 + comment=systemd.mount + 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. + + + + 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 for this target unit to + all SysV init script service + units with an LSB header + referring to the + $network + facility. + + + + 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 + $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. + + 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 + $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 for this target unit to + all SysV init script service + units with an LSB header + referring to the + $rpcbind + facility. + + + + rtc-set.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 + $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 + + A special target unit + that terminates the services + on system shutdown. + + Services that shall be + terminated on system shutdown + 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 script + service units that shall be + terminated in SysV runlevels 0 + or 6. + + + + sigpwr.target + + A special target that is + started when systemd receives + the SIGPWR process signal, + which is normally sent by the + kernel or UPS daemons when + power fails. + + + + sockets.target + + A special target unit + that sets up all service + sockets. + + Services that can be + socket-activated shall add + Wants dependencies to this + unit for their socket unit + during installation. + + + + swap.target + + Similar to + local-fs.target, but for swap + partitions and swap + files. + + + + 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. + + Administrators should + ensure that this target pulls + in a service unit with the + name or alias of + @SPECIAL_SYSLOG_SERVICE@ + (or a socket unit that + activates this + service). + + + + 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. + + + + systemd-initctl.socket + + Socket activation unit + for + system-initctl.service. + + + + systemd-logger.service + + This is internally used + by systemd to provide syslog + logging to the processes it + maintains. + This is a + socket-activated service, see + system-logger.socket. + + + + systemd-logger.socket + + Socket activation unit + for + 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. + + + + + + + Special Session Units + + 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, + sockets.target, + swap.target. + + + + See Also + + systemd.unit5 + systemd.service5 + systemd.socket5 + systemd.target5 + + + + -- cgit v1.2.3-54-g00ecf