From: Zbigniew Jędrzejewski-Szmek Date: Tue, 2 Jun 2020 12:26:26 +0000 (+0200) Subject: man: add note that emergency.target inherits mount state X-Git-Tag: v246-rc1~213^2 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F16056%2Fhead;p=thirdparty%2Fsystemd.git man: add note that emergency.target inherits mount state Based on an internal discussion whether emergency.target should remount disks ro, or maybe remount them rw, or do nothing. In some cases people want to boot ro, and always remounting rw would break that. In other cases, remounting disks ro after they have already been mounted rw is mostly pointless and might even not be possible. So let's just document that we don't change the state. Also: any→other, since emergency.service *is* pulled in. Also: just advertise "emergency" as the way to boot into the target. We are not going to remove this option, and it's way easier to type than "systemd.unit=emergency.target". --- diff --git a/man/systemd.special.xml b/man/systemd.special.xml index 8cd4c15f28c..9f368f903dc 100644 --- a/man/systemd.special.xml +++ b/man/systemd.special.xml @@ -228,22 +228,25 @@ emergency.target 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 + target does not pull in other 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 + are usually just the system manager (PID 1) and the shell process. This unit may be used + by specifying emergency on the kernel command line; 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. + + Note that depending on how emergency.target is reached, the root file + system might be mounted read-only or read-write (no remounting is done specially for this + target). For example, the system may boot with root mounted read-only when ro + is used on the kernel command line and remain this way for emergency.target, + or the system may transition to emergency.target after the system has been + partially booted and disks have already been remounted read-write.