From: Lennart Poettering <lennart@poettering.net>
Date: Wed, 14 May 2025 12:36:09 +0000 (+0200)
Subject: man: document that gpt-label/gpt-type uuid xattrs are now lists
X-Git-Tag: v258-rc1~620^2~1
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=778cfac5fba45b7ac828571704945b722b2fb718;p=thirdparty%2Fsystemd.git

man: document that gpt-label/gpt-type uuid xattrs are now lists
---

diff --git a/man/repart.d.xml b/man/repart.d.xml
index 27c78f63dad..fde83b09786 100644
--- a/man/repart.d.xml
+++ b/man/repart.d.xml
@@ -962,12 +962,12 @@
       <varlistentry>
         <term><varname>AddValidateFS=</varname></term>
 
-        <listitem><para>Takes a boolean argument. If enabled will set the <varname>user.validatefs.gpt_label</varname>,
-        <varname>user.validatefs.gpt_type_uuid</varname> and <varname>user.validatefs.mount_point</varname>
-        extended attributes on the root inode of the formatted file system to the partition label, partition
-        type UUID and the intended mount point for the partition. Defaults to on if
-        <varname>Format=</varname> is used and the specified argument is neither <literal>swap</literal> nor
-        <literal>vfat</literal>.</para>
+        <listitem><para>Takes a boolean argument. If enabled will set the
+        <varname>user.validatefs.gpt_label</varname>, <varname>user.validatefs.gpt_type_uuid</varname> and
+        <varname>user.validatefs.mount_point</varname> extended attributes on the root inode of the formatted
+        file system to the partition labels, partition type UUIDs and the intended mount point for the file
+        system. Defaults to on if <varname>Format=</varname> is used and the specified argument is neither
+        <literal>swap</literal> nor <literal>vfat</literal>.</para>
 
         <para>These extended attributes are read by
         <citerefentry><refentrytitle>systemd-validatefs@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
diff --git a/man/systemd-validatefs@.service.xml b/man/systemd-validatefs@.service.xml
index f0c7aabc6e9..17f3da987d3 100644
--- a/man/systemd-validatefs@.service.xml
+++ b/man/systemd-validatefs@.service.xml
@@ -50,13 +50,16 @@
       mounted to a location not matching any of the listed paths the validation check will
       fail.</para></listitem>
 
-      <listitem><para><varname>user.validatefs.gpt_label</varname>: this extended attribute may contain a
-      free-form string. It is compared with the partition label string of the partition this file system is
-      located on, and if different the validation will fail.</para></listitem>
-
-      <listitem><para><varname>user.validatefs.gpt_type_uuid</varname>: this extended attribute may contain a
-      GPT partition type UUID formatted as string. It is compared with the partition type UUID of the
-      partition this file system is located on, and if different the validation will fail.</para></listitem>
+      <listitem><para><varname>user.validatefs.gpt_label</varname>: this extended attribute may contain a one
+      or more free-form strings, separated by NUL bytes. If set, all backing partitions of the file system
+      are checked against this list, and if any backing partition's label is not listed, the validation will
+      fail. Note that there may be multiple backing partition in case of Verity setups, which combines a data
+      and a hash partition.</para></listitem>
+
+      <listitem><para><varname>user.validatefs.gpt_type_uuid</varname>: this extended attribute may contain
+      one or more GPT partition type UUIDs, formatted as string, separated by NUL bytes. As above, all
+      backing partitions of the file system are checked against this list, and if none is matching the
+      validation will fail.</para></listitem>
     </orderedlist>
 
     <para>The <filename>systemd-validatefs@.service</filename> unit is automatically pulled into the initial