|
571 | 571 | <varlistentry> |
572 | 572 | <term><varname>Flags=</varname></term> |
573 | 573 |
|
574 | | - <listitem><para>Configures the 64bit GPT partition flags to set for the partition when creating |
| 574 | + <listitem><para>Configures the 64bit GPT partition flags field to set for the partition when creating |
575 | 575 | it. This option has no effect if the partition already exists. If not specified the flags values is |
576 | | - set to all zeroes, except if the partition type (as configured with <varname>Type=</varname> above) |
577 | | - refers to a Verity partition, in which case bit 60 is set (i.e. the read-only bit). This bit may also |
578 | | - be configured separately via <varname>ReadOnly=</varname>, see below. Specify the flags value in |
579 | | - hexadecimal (by prefixing it with <literal>0x</literal>), binary (prefix <literal>0b</literal>) or |
580 | | - decimal (no prefix).</para></listitem> |
| 576 | + set to all zeroes, except for the three bits that can also be configured via |
| 577 | + <varname>NoAuto=</varname>, <varname>ReadOnly=</varname> and <varname>GrowFileSystem=</varname>; see |
| 578 | + below for details on the defaults for these three flags. Specify the flags value in hexadecimal (by |
| 579 | + prefixing it with <literal>0x</literal>), binary (prefix <literal>0b</literal>) or decimal (no |
| 580 | + prefix).</para></listitem> |
581 | 581 | </varlistentry> |
582 | 582 |
|
583 | 583 | <varlistentry> |
| 584 | + <term><varname>NoAuto=</varname></term> |
584 | 585 | <term><varname>ReadOnly=</varname></term> |
585 | 586 | <term><varname>GrowFileSystem=</varname></term> |
586 | 587 |
|
587 | | - <listitem><para>Configures the Read-Only and Grow-File-System partition flags (bit 60 and 59) of the |
588 | | - partition table entry, as defined by the <ulink |
| 588 | + <listitem><para>Configures the No-Auto, Read-Only and Grow-File-System partition flags (bit 63, 60 |
| 589 | + and 59) of the partition table entry, as defined by the <ulink |
589 | 590 | url="https://systemd.io/DISCOVERABLE_PARTITIONS">Discoverable Partitions Specification</ulink>. Only |
590 | | - available for partition types supported by the specification. This option is a friendly way to set bit |
591 | | - 60 and 59 of the partition flags value without setting any of the other bits, and may be set via |
592 | | - <varname>Flags=</varname> too, see above.</para> |
| 591 | + available for partition types supported by the specification. This option is a friendly way to set |
| 592 | + bits 63, 60 and 59 of the partition flags value without setting any of the other bits, and may be set |
| 593 | + via <varname>Flags=</varname> too, see above.</para> |
593 | 594 |
|
594 | | - <para>If <varname>Flags=</varname> is used in conjunction with one or both of |
595 | | - <varname>ReadOnly=</varname>/<varname>GrowFileSystem=</varname> the latter control the value of the |
596 | | - relevant flags, i.e. the high-level settings |
597 | | - <varname>ReadOnly=</varname>/<varname>GrowFileSystem=</varname> override the low-level setting |
598 | | - <varname>Flags=</varname>.</para> |
| 595 | + <para>If <varname>Flags=</varname> is used in conjunction with one or more of |
| 596 | + <varname>NoAuto=</varname>/<varname>ReadOnly=</varname>/<varname>GrowFileSystem=</varname> the latter |
| 597 | + control the value of the relevant flags, i.e. the high-level settings |
| 598 | + <varname>NoAuto=</varname>/<varname>ReadOnly=</varname>/<varname>GrowFileSystem=</varname> override |
| 599 | + the relevant bits of the low-level setting <varname>Flags=</varname>.</para> |
599 | 600 |
|
600 | | - <para>Note that the two flags affect only automatic partition mounting, as implemented by |
| 601 | + <para>Note that the three flags affect only automatic partition mounting, as implemented by |
601 | 602 | <citerefentry><refentrytitle>systemd-gpt-auto-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry> |
602 | 603 | or the <option>--image=</option> option of various commands (such as |
603 | 604 | <citerefentry><refentrytitle>systemd-nspawn</refentrytitle><manvolnum>1</manvolnum></citerefentry>). It |
|
611 | 612 | precedence in most tools reading these flags, and since growing the file system involves writing to |
612 | 613 | the partition it is consequently ignored.</para> |
613 | 614 |
|
614 | | - <para><varname>ReadOnly=</varname> defaults to on for Verity partition |
615 | | - types. <varname>GrowFileSystem=</varname> defaults to on for all partition types that support it, |
616 | | - except if the partition is marked read-only (and thus effectively, defaults to off for Verity |
617 | | - partitions).</para></listitem> |
| 615 | + <para><varname>NoAuto=</varname> defaults to off. <varname>ReadOnly=</varname> defaults to on for |
| 616 | + Verity partition types, and off for all others. <varname>GrowFileSystem=</varname> defaults to on for |
| 617 | + all partition types that support it, except if the partition is marked read-only (and thus |
| 618 | + effectively, defaults to off for Verity partitions).</para></listitem> |
618 | 619 | </varlistentry> |
619 | 620 | </variablelist> |
620 | 621 | </refsect1> |
|
0 commit comments