From: Jan Engelhardt <jengelh@inai.de>
Date: Thu, 7 Nov 2013 00:17:49 +0000 (+0100)
Subject: man: add rationale into systemd-halt(8)
X-Git-Tag: v209~1574
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=3f09ee19690730cd69e4986d72da2d9bb7c04a6a;p=elogind.git

man: add rationale into systemd-halt(8)

The explanation is from
http://people.debian.org/~stapelberg/docs/systemd-dependencies.html
---

diff --git a/man/systemd-halt.service.xml b/man/systemd-halt.service.xml
index 2fd7b8bf8..0737d058d 100644
--- a/man/systemd-halt.service.xml
+++ b/man/systemd-halt.service.xml
@@ -83,6 +83,12 @@
                 remaining swap devices, detach all remaining storage
                 devices and kill all remaining processes.</para>
 
+                <para>It is necessary to have this code in a separate binary
+                because otherwise rebooting after an upgrade might be broken —
+                the running PID 1 could still depend on libraries which are not
+                available any more, thus keeping the filesystem busy, which
+                then cannot be re-mounted read-only.</para>
+
                 <para>Immediately before executing the actual system
                 halt/poweroff/reboot/kexec
                 <filename>systemd-shutdown</filename> will run all