From: Lennart Poettering <lennart@poettering.net>
Date: Mon, 2 May 2022 14:42:50 +0000 (+0200)
Subject: man: document that systemd-fstab-generator actually cares about roothash=/usrhash... 
X-Git-Tag: v251-rc2~30
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=ba4b74cbc7bceed60dbf8b8ff992371e949c80fd;p=thirdparty%2Fsystemd.git

man: document that systemd-fstab-generator actually cares about roothash=/usrhash= on the kernel cmdline

It doesn't really care about the hash value passed (which is processed
by systemd-veritysetup-generator), but it does care about the fact that
it is set (and mounts the DM nodes /dev/mapper/usr + /dev/mapper/root in
that case).
---

diff --git a/man/systemd-fstab-generator.xml b/man/systemd-fstab-generator.xml
index 3c5a5cc50a3..21fa85da7d8 100644
--- a/man/systemd-fstab-generator.xml
+++ b/man/systemd-fstab-generator.xml
@@ -171,6 +171,18 @@
         initrd.</para></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><varname>roothash=</varname></term>
+        <term><varname>usrhash=</varname></term>
+
+        <listitem><para>These options are primarily read by
+        <citerefentry><refentrytitle>systemd-veritysetup-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>. When
+        set this indicates that the root file system (or <filename>/usr/</filename>) shall be mounted from
+        Verity volumes with the specified hashes. If these kernel command line options are set the root (or
+        <filename>/usr/</filename>) file system is thus mounted from a device mapper volume
+        <filename>/dev/mapper/root</filename> (or <filename>/dev/mapper/usr</filename>).</para></listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><varname>systemd.volatile=</varname></term>