]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: document that gpt-label/gpt-type uuid xattrs are now lists
authorLennart Poettering <lennart@poettering.net>
Wed, 14 May 2025 12:36:09 +0000 (14:36 +0200)
committerLennart Poettering <lennart@poettering.net>
Wed, 14 May 2025 13:44:54 +0000 (15:44 +0200)
man/repart.d.xml
man/systemd-validatefs@.service.xml

index 27c78f63dad2b4b95c69f1339cf964e7af29b568..fde83b09786ca443bcf6fff5b2ad461467f2de50 100644 (file)
       <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>
index f0c7aabc6e987f5238e3e9b8d37fe8a209c14168..17f3da987d3d978e773b660a727cfb02e9b24da1 100644 (file)
       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