X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Fsystemd.special.xml;h=14998b9647dd089f6f1b11fd38d4834ddfbba69d;hb=ccddd104fc95e0e769142af6e1fe1edec5be70a6;hp=d28f3d5f90d44aebc82cb7762f0b02bbcc0e244f;hpb=d90833c93c5fd171440d0d5bbe42f5aab88e393f;p=thirdparty%2Fsystemd.git
diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index d28f3d5f90d..14998b9647d 100644
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -92,6 +92,7 @@
shutdown.target,
sigpwr.target,
sleep.target,
+ slices.target,
smartcard.target,
sockets.target,
sound.target,
@@ -203,12 +204,22 @@
emergency.target
- A special target unit that starts an emergency shell
- on the main console. This unit is supposed to be used with
- the kernel command line option
- systemd.unit= and has otherwise little
- use.
-
+ A special target unit that starts an emergency shell on the main console. This target does not pull in
+ any services or mounts. It is the most minimal version of starting the system in order to acquire an
+ interactive shell; the only processes running are usually just the system manager (PID 1) and the shell
+ process. This unit is supposed to be used with the kernel command line option
+ systemd.unit=; it is also used when a file system check on a required file system fails,
+ and boot-up cannot continue. Compare with rescue.target, which serves a similar purpose,
+ but also starts the most basic services and mounts all file systems.
+
+ Use the systemd.unit=emergency.target kernel command line option to boot into this
+ mode. A short alias for this kernel command line option is emergency, for compatibility
+ with SysV.
+
+ In many ways booting into emergency.target is similar to the effect of booting
+ with init=/bin/sh on the kernel command line, except that emergency mode provides you with
+ the full system and service manager, and allows starting individual units in order to continue the boot
+ process in steps.
@@ -439,11 +450,18 @@
rescue.target
- A special target unit for setting up the base system
- and a rescue shell.
+ A special target unit that pulls in the base system (including system mounts) and spawns a rescue
+ shell. Isolate to this target in order to administer the system in single-user mode with all file systems
+ mounted but with no services running, except for the most basic. Compare with
+ emergency.target, which is much more reduced and does not provide the file systems or
+ most basic services.
- runlevel1.target is an alias for
- this target unit, for compatibility with SysV.
+ runlevel1.target is an alias for this target unit, for compatibility with
+ SysV.
+
+ Use the systemd.unit=rescue.target kernel command line option to boot into this
+ mode. A short alias for this kernel command line option is 1, for compatibility with
+ SysV.
@@ -502,11 +520,24 @@
hook units into the sleep state logic.
+
+ slices.target
+
+ A special target unit that sets up all slice units (see
+ systemd.slice5 for
+ details) that shall be active after boot. By default the generic user.slice,
+ system.slice, machines.slice slice units, as well as the root
+ slice unit -.slice are pulled in and ordered before this unit (see below).
+
+ It's a good idea to add WantedBy=slices.target lines to the [Install]
+ section of all slices units that may be installed dynamically.
+
+
sockets.target
A special target unit that sets up all socket
- units.(see
+ units (see
systemd.socket5
for details) that shall be active after boot.
@@ -711,7 +742,7 @@
defined what that is supposed to mean, with one exception:
at shutdown, a unit that is ordered after
network.target will be stopped before
- the network -- to whatever level it might be set up then --
+ the network â to whatever level it might be set up then â
is shut down. It is hence useful when writing service files
that require network access on shutdown, which should order
themselves after this target, but not pull it in. Also see