From 6d9e45e97fb1157d5670d533f55819a59e7ae336 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Janne=20He=C3=9F?= <jannehess@gmail.com>
Date: Wed, 23 Nov 2016 05:19:56 +0100
Subject: [PATCH] Document an edge-case with resume and mounting (#4581)

When trying to read keyfiles from an encrypted partition to unlock the swap,
a cyclic dependency is generated because systemd can not mount the
filesystem before it has checked if there is a swap to resume from.

Closes #3940
---
 man/bootup.xml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/man/bootup.xml b/man/bootup.xml
index 986996398c..b92c60f43a 100644
--- a/man/bootup.xml
+++ b/man/bootup.xml
@@ -179,6 +179,13 @@
     identical to the system manager bootup (see above) until it
     reaches <filename>basic.target</filename>. From there, systemd
     approaches the special target <filename>initrd.target</filename>.
+
+    Before any file systems are mounted, it must be determined whether
+    the system will resume from hibernation or proceed with normal boot.
+    This is accomplished by <filename>systemd-hibernate-resume@.service</filename>
+    which must be finished before <filename>local-fs-pre.target</filename>,
+    so no filesystems can be mounted before the check is complete.
+
     When the root device becomes available,
     <filename>initd-root-device.target</filename> is reached.
     If the root device can be mounted at