]> git.ipfire.org Git - thirdparty/systemd.git/blobdiff - man/repart.d.xml
man: add version info
[thirdparty/systemd.git] / man / repart.d.xml
index ac72d0e8456c6e7973d5c97b0ee23933edeebbfd..b8a2e7b8b99c5dd1a3fd2cdc6cff5b2841f16a1c 100644 (file)
 
         <para>Most of the partition type UUIDs listed above are defined in the <ulink
         url="https://uapi-group.org/specifications/specs/discoverable_partitions_specification">Discoverable Partitions
-        Specification</ulink>.</para></listitem>
+        Specification</ulink>.</para>
+
+        <xi:include href="version-info.xml" xpointer="v245"/></listitem>
       </varlistentry>
 
       <varlistentry>
         setting is not used for matching. It is also not used when a label is already set for an existing
         partition. It is thus only used when a partition is newly created or when an existing one had a no
         label set (that is: an empty label). If not specified a label derived from the partition type is
-        automatically used. Simple specifier expansion is supported, see below.</para></listitem>
+        automatically used. Simple specifier expansion is supported, see below.</para>
+
+        <xi:include href="version-info.xml" xpointer="v245"/></listitem>
       </varlistentry>
 
       <varlistentry>
         setting is not used for matching. It is also not used when a UUID is already set for an existing
         partition. It is thus only used when a partition is newly created or when an existing one had a
         all-zero UUID set. If set to <literal>null</literal>, the UUID is set to all zeroes. If not specified
-        a UUID derived from the partition type is automatically used.</para></listitem>
+        a UUID derived from the partition type is automatically used.</para>
+
+        <xi:include href="version-info.xml" xpointer="v246"/></listitem>
       </varlistentry>
 
       <varlistentry>
         removed. If all partitions with a priority above 0 are removed and the partitions still do not fit on
         the device the operation fails. Note that this priority has no effect on ordering partitions, for
         that use the alphabetical order of the filenames of the partition definition files. Defaults to
-        0.</para></listitem>
+        0.</para>
+
+        <xi:include href="version-info.xml" xpointer="v245"/></listitem>
       </varlistentry>
 
       <varlistentry>
         "elastic" fashion, based on the disk size and existing partitions. If a partition shall have a fixed
         size use both <varname>SizeMinBytes=</varname> and <varname>SizeMaxBytes=</varname> with the same
         value in order to fixate the size to one value, in which case the weight has no
-        effect.</para></listitem>
+        effect.</para>
+
+        <xi:include href="version-info.xml" xpointer="v245"/></listitem>
       </varlistentry>
 
       <varlistentry>
         weight. Defaults to 0, i.e. by default no padding is applied.</para>
 
         <para>Padding is useful if empty space shall be left for later additions or a safety margin at the
-        end of the device or between partitions.</para></listitem>
+        end of the device or between partitions.</para>
+
+        <xi:include href="version-info.xml" xpointer="v245"/></listitem>
       </varlistentry>
 
       <varlistentry>
         fulfill the constraints placing the partition will fail. For partitions that shall be created,
         depending on the setting of <varname>Priority=</varname> (see above) the partition might be dropped
         and the placing algorithm restarted. By default a minimum size constraint of 10M and no maximum size
-        constraint is set.</para></listitem>
+        constraint is set.</para>
+
+        <xi:include href="version-info.xml" xpointer="v245"/></listitem>
       </varlistentry>
 
       <varlistentry>
         partition (the "padding"). Semantics are similar to <varname>SizeMinBytes=</varname> and
         <varname>SizeMaxBytes=</varname>, except that unlike partition sizes free space can be shrunk and can
         be as small as zero. By default no size constraints on padding are set, so that only
-        <varname>PaddingWeight=</varname> determines the size of the padding applied.</para></listitem>
+        <varname>PaddingWeight=</varname> determines the size of the padding applied.</para>
+
+        <xi:include href="version-info.xml" xpointer="v245"/></listitem>
       </varlistentry>
 
       <varlistentry>
         the partition exists but is not or only partially populated.</para>
 
         <para>This option cannot be combined with <varname>Format=</varname> or
-        <varname>CopyFiles=</varname>.</para></listitem>
+        <varname>CopyFiles=</varname>.</para>
+
+        <xi:include href="version-info.xml" xpointer="v246"/></listitem>
       </varlistentry>
 
       <varlistentry>
         before the partition is created, ensuring that the partition only ever exists with a fully
         initialized file system.</para>
 
-        <para>This option cannot be combined with <varname>CopyBlocks=</varname>.</para></listitem>
+        <para>This option cannot be combined with <varname>CopyBlocks=</varname>.</para>
+
+        <xi:include href="version-info.xml" xpointer="v247"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <citerefentry><refentrytitle>systemd-repart</refentrytitle><manvolnum>8</manvolnum></citerefentry>
         is invoked with the <option>--image=</option> or <option>--root=</option> command line switches the
         source paths specified are taken relative to the specified root directory or disk image root.
-        </para></listitem>
+        </para>
+
+        <xi:include href="version-info.xml" xpointer="v247"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <citerefentry><refentrytitle>systemd-repart</refentrytitle><manvolnum>8</manvolnum></citerefentry>
         is invoked with the <option>--image=</option> or <option>--root=</option> command line switches the
         paths specified are taken relative to the specified root directory or disk image root.
-        </para></listitem>
+        </para>
+
+        <xi:include href="version-info.xml" xpointer="v254"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <citerefentry><refentrytitle>systemd-tmpfiles</refentrytitle><manvolnum>8</manvolnum></citerefentry>
         with its <option>--image=</option> option to pre-create other, more complex directory hierarchies (as
         well as other inodes) with fine-grained control of ownership, access modes and other file
-        attributes.</para></listitem>
+        attributes.</para>
+
+        <xi:include href="version-info.xml" xpointer="v249"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <literal>btrfs</literal>.</para>
 
         <para>Note that due to limitations of <literal>mkfs.btrfs</literal>, this option is only supported
-        when running with <option>--offline=no</option>.</para></listitem>
+        when running with <option>--offline=no</option>.</para>
+
+        <xi:include href="version-info.xml" xpointer="v255"/></listitem>
       </varlistentry>
 
       <varlistentry>
         of <varname>Format=</varname> and <varname>CopyBlocks=</varname> are increased by the space necessary
         for the LUKS2 superblock (see above).</para>
 
-        <para>This option has no effect if the partition already exists.</para></listitem>
+        <para>This option has no effect if the partition already exists.</para>
+
+        <xi:include href="version-info.xml" xpointer="v247"/></listitem>
       </varlistentry>
 
       <varlistentry>
 
         <para>For each unique <varname>VerityMatchKey=</varname> value, a single verity data partition
         (<literal>Verity=data</literal>) and a single verity hash partition (<literal>Verity=hash</literal>)
-        must be defined.</para></listitem>
+        must be defined.</para>
+
+        <xi:include href="version-info.xml" xpointer="v252"/></listitem>
       </varlistentry>
 
       <varlistentry>
 
         <listitem><para>Takes a short, user-chosen identifier string. This setting is used to find sibling
         verity partitions for the current verity partition. See the description for
-        <varname>Verity=</varname>.</para></listitem>
+        <varname>Verity=</varname>.</para>
+
+        <xi:include href="version-info.xml" xpointer="v252"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <listitem><para>Configures the data block size of the generated verity hash partition. Must be between 512 and
         4096 bytes and must be a power of 2. Defaults to the sector size if configured explicitly, or the underlying
         block device sector size, or 4K if systemd-repart is not operating on a block device.
-        </para></listitem>
+        </para>
+
+        <xi:include href="version-info.xml" xpointer="v255"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <listitem><para>Configures the hash block size of the generated verity hash partition. Must be between 512 and
         4096 bytes and must be a power of 2. Defaults to the sector size if configured explicitly, or the underlying
         block device sector size, or 4K if systemd-repart is not operating on a block device.
-        </para></listitem>
+        </para>
+
+        <xi:include href="version-info.xml" xpointer="v255"/></listitem>
       </varlistentry>
 
       <varlistentry>
 
         <listitem><para>Takes a boolean argument. If specified the partition is marked for removal during a
         factory reset operation. This functionality is useful to implement schemes where images can be reset
-        into their original state by removing partitions and creating them anew. Defaults to off.</para></listitem>
+        into their original state by removing partitions and creating them anew. Defaults to off.</para>
+
+        <xi:include href="version-info.xml" xpointer="v245"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <varname>NoAuto=</varname>, <varname>ReadOnly=</varname> and <varname>GrowFileSystem=</varname>; see
         below for details on the defaults for these three flags. Specify the flags value in hexadecimal (by
         prefixing it with <literal>0x</literal>), binary (prefix <literal>0b</literal>) or decimal (no
-        prefix).</para></listitem>
+        prefix).</para>
+
+        <xi:include href="version-info.xml" xpointer="v249"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <para><varname>NoAuto=</varname> defaults to off. <varname>ReadOnly=</varname> defaults to on for
         Verity partition types, and off for all others. <varname>GrowFileSystem=</varname> defaults to on for
         all partition types that support it, except if the partition is marked read-only (and thus
-        effectively, defaults to off for Verity partitions).</para></listitem>
+        effectively, defaults to off for Verity partitions).</para>
+
+        <xi:include href="version-info.xml" xpointer="v249"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <citerefentry><refentrytitle>systemd-repart</refentrytitle><manvolnum>8</manvolnum></citerefentry> is
         used. Simple specifier expansion is supported, see below. Defaults to <literal>%t</literal>. To
         disable split artifact generation for a partition, set <varname>SplitName=</varname> to
-        <literal>-</literal>.</para></listitem>
+        <literal>-</literal>.</para>
+
+        <xi:include href="version-info.xml" xpointer="v252"/></listitem>
       </varlistentry>
 
       <varlistentry>
         <varname>CopyFiles=</varname>. Note that unless the filesystem is a read-only filesystem,
         <command>systemd-repart</command> will have to populate the filesystem twice to guess the minimal
         required size, so enabling this option might slow down repart when populating large partitions.
-        </para></listitem>
+        </para>
+
+        <xi:include href="version-info.xml" xpointer="v253"/></listitem>
       </varlistentry>
     </variablelist>
   </refsect1>