From 9f23530860942a8f94b7c535ead80c38f02424b1 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Sun, 16 May 2010 22:45:11 +0200 Subject: man: document a few special units --- man/systemd.special.xml | 325 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 325 insertions(+) create mode 100644 man/systemd.special.xml (limited to 'man/systemd.special.xml') diff --git a/man/systemd.special.xml b/man/systemd.special.xml new file mode 100644 index 0000000000..3f9286d4b4 --- /dev/null +++ b/man/systemd.special.xml @@ -0,0 +1,325 @@ + + + + + + + + + systemd.special + systemd + + + + Developer + Lennart + Poettering + lennart@poettering.net + + + + + + systemd.special + 7 + + + + systemd.special + special systemd units + + + + emergency.service + local-fs.target + network.target + nss-lookup.target + remote-fs.target + rpcbind.target + rtc-set.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 + + + + 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. + + + + + 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 + /etc/fstab + that have the + auto and + comment=systemd.mount + mount options set. + + systemd automatically + adds dependencies of type + After to this target unit for + all SysV init scripts with an + LSB header referring to the + $local_fs + facility. + + + + 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 + $network + facility. + + + + nss-lookup.target + + systemd automatically + adds dependencies of type + After to this target unit for + all SysV init scripts with an + LSB header referring to the + $named + facility. + + + + remote-fs.target + + 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 + $remote-fs + facility. + + + + 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 + $rpcbind + facility. + + + + rtc-set.target + + systemd automatically + adds dependencies of type + After to this target unit for + all SysV init scripts with an + LSB header referring to the + $time + facility. + + + + shutdown.target + + A special target unit + that terminates the services + on system shutdown. + + Services that shall be + terminated on system shutdown + shall add Wants dependencies + from this unit to 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. + + + + 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 the + power fails. + + + + sockets.target + + A special target unit + that sets up all service + sockets. + + Services that can be + socket-activated shall add + Wants dependencies from this + unit to 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 to this target unit for + all SysV init scripts 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_NAME@ (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 used internally + by systemd to provide syslog + logging to started + processes. + This is a + socket-activated service, see + system-logger.socket. + + + + systemd-logger.socket + + Socket activation unit + for + system-logger.service. + + + + + + + Special Session Units + + When systemd runs as a service instance, the + following special units are available, which have + similar definitions as their system counterparts: + 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