ecbff1
From 3608a654d9d9c4f9d75454e5fe190ef938e9a4f4 Mon Sep 17 00:00:00 2001
ecbff1
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
ecbff1
Date: Thu, 12 Oct 2017 22:43:58 +0200
ecbff1
Subject: [PATCH] man: add a note about _netdev usage
ecbff1
ecbff1
Cherry-picked from: 288c26165e0ff71857394f360f42432bc808556f
ecbff1
Resolves: #1477757
ecbff1
---
ecbff1
 man/crypttab.xml | 12 +++++++++++-
ecbff1
 1 file changed, 11 insertions(+), 1 deletion(-)
ecbff1
ecbff1
diff --git a/man/crypttab.xml b/man/crypttab.xml
ecbff1
index a9197ab40..e4ecab3dc 100644
ecbff1
--- a/man/crypttab.xml
ecbff1
+++ b/man/crypttab.xml
ecbff1
@@ -199,7 +199,16 @@
ecbff1
         will be ordered between <filename>remote-fs-pre.target</filename> and
ecbff1
         <filename>remote-cryptsetup.target</filename>, instead of
ecbff1
         <filename>cryptsetup-pre.target</filename> and
ecbff1
-        <filename>cryptsetup.target</filename>.</para></listitem>
ecbff1
+        <filename>cryptsetup.target</filename>.</para>
ecbff1
+
ecbff1
+        <para>Hint: if this device is used for a mount point that is specified in
ecbff1
+        <citerefentry project='man-pages'><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
ecbff1
+        the <option>_netdev</option> option should also be used for the mount
ecbff1
+        point. Otherwise, a dependency loop might be created where the mount point
ecbff1
+        will be pulled in by <filename>local-fs.target</filename>, while the
ecbff1
+        service to configure the network is usually only started <emphasis>after</emphasis>
ecbff1
+        the local file system has been mounted.</para>
ecbff1
+        </listitem>
ecbff1
       </varlistentry>
ecbff1
 
ecbff1
       <varlistentry>
ecbff1
@@ -396,6 +405,7 @@ hidden     /mnt/tc_hidden  /dev/null    tcrypt-hidden,tcrypt-keyfile=/etc/keyfil
ecbff1
       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
ecbff1
       <citerefentry><refentrytitle>systemd-cryptsetup@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
ecbff1
       <citerefentry><refentrytitle>systemd-cryptsetup-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
ecbff1
+      <citerefentry project='man-pages'><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
ecbff1
       <citerefentry project='die-net'><refentrytitle>cryptsetup</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
ecbff1
       <citerefentry project='man-pages'><refentrytitle>mkswap</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
ecbff1
       <citerefentry project='man-pages'><refentrytitle>mke2fs</refentrytitle><manvolnum>8</manvolnum></citerefentry>