9fc0f6
From e701defc239f63731940b8d0867405e0b36b9ada Mon Sep 17 00:00:00 2001
9fc0f6
From: Jan Engelhardt <jengelh@inai.de>
9fc0f6
Date: Thu, 7 Nov 2013 01:17:49 +0100
9fc0f6
Subject: [PATCH] man: add rationale into systemd-halt(8)
9fc0f6
9fc0f6
The explanation is from
9fc0f6
http://people.debian.org/~stapelberg/docs/systemd-dependencies.html
9fc0f6
---
9fc0f6
 man/systemd-halt.service.xml | 6 ++++++
9fc0f6
 1 file changed, 6 insertions(+)
9fc0f6
9fc0f6
diff --git a/man/systemd-halt.service.xml b/man/systemd-halt.service.xml
9fc0f6
index 812281e..90b443f 100644
9fc0f6
--- a/man/systemd-halt.service.xml
9fc0f6
+++ b/man/systemd-halt.service.xml
9fc0f6
@@ -83,6 +83,12 @@
9fc0f6
                 remaining swap devices, detach all remaining storage
9fc0f6
                 devices and kill all remaining processes.</para>
9fc0f6
 
9fc0f6
+                <para>It is necessary to have this code in a separate binary
9fc0f6
+                because otherwise rebooting after an upgrade might be broken —
9fc0f6
+                the running PID 1 could still depend on libraries which are not
9fc0f6
+                available any more, thus keeping the filesystem busy, which
9fc0f6
+                then cannot be re-mounted read-only.</para>
9fc0f6
+
9fc0f6
                 <para>Immediately before executing the actual system
9fc0f6
                 halt/poweroff/reboot/kexec
9fc0f6
                 <filename>systemd-shutdown</filename> will run all