diff options
| author | Lennart Poettering <lennart@poettering.net> | 2021-04-21 16:41:12 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2021-04-23 17:56:34 +0200 |
| commit | 74a54baeecfeb7bb4bcd06b16110e58812e2f037 (patch) | |
| tree | 15d839ab4fe6b2f9a30edd7ca45d05b4ee37a5ac /man/systemd-dissect.xml | |
| parent | dissect-image: optionally, grow file systems on mount (diff) | |
| download | systemd-74a54baeecfeb7bb4bcd06b16110e58812e2f037.tar.xz systemd-74a54baeecfeb7bb4bcd06b16110e58812e2f037.zip | |
dissect: enable growfs by default, but make it configurable
This adds a new --growfs=yes|no switch to systemd-dissect, defaulting to
on.
Diffstat (limited to 'man/systemd-dissect.xml')
| -rw-r--r-- | man/systemd-dissect.xml | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/man/systemd-dissect.xml b/man/systemd-dissect.xml index 0de772cf5e..4cdac2b013 100644 --- a/man/systemd-dissect.xml +++ b/man/systemd-dissect.xml @@ -195,6 +195,28 @@ </varlistentry> <varlistentry> + <term><option>--growfs=no</option></term> + + <listitem><para>Turn off automatic growing of accessed file systems to their partition size, if + marked for that in the GPT partition table. By default when an image is accessed for writing (by + <option>--mount</option> or <option>--copy-to</option>) the file systems contained in the OS image + are automatically grown to their partition sizes, if bit 59 in the GPT partition flags is set for + partition types that are defined by the <ulink + url="https://systemd.io/DISCOVERABLE_PARTITIONS">Discoverable Partitions Specification</ulink>. This + behavior may be switched off using <option>--growfs=no</option>. File systems are grown automatically + on access if all of the following conditions are met:</para> + <orderedlist> + <listitem><para>The file system is mounted writable</para></listitem> + <listitem><para>The file system currently is smaller than the partition it is contained in (and thus can be grown)</para></listitem> + <listitem><para>The image contains a GPT partition table</para></listitem> + <listitem><para>The file system is stored on a partition defined by the Discoverable Partitions Specification</para></listitem> + <listitem><para>Bit 59 of the GPT partition flags for this partition is set, as per specification</para></listitem> + <listitem><para>The <option>--growfs=no</option> option is not passed.</para></listitem> + </orderedlist> + </listitem> + </varlistentry> + + <varlistentry> <term><option>--mkdir</option></term> <listitem><para>If combined with <option>--mount</option> the directory to mount the OS image to is |