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

This commit is contained in:
Lennart Poettering
2025-05-14 14:36:09 +02:00
parent 02347d24e4
commit 778cfac5fb
2 changed files with 15 additions and 12 deletions

View File

@@ -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>

View File

@@ -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_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 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_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