summaryrefslogtreecommitdiff
path: root/man/repart.d.xml
diff options
context:
space:
mode:
authorDaan De Meyer <daan.j.demeyer@gmail.com>2022-12-13 18:52:18 +0000
committerYu Watanabe <watanabe.yu+github@gmail.com>2022-12-15 15:09:09 +0900
commit5c33b6865246f0651ced43048fa1cb58cbc0c35b (patch)
treef4daa0e167c2eb571e5cc037b7008b781d8f05e6 /man/repart.d.xml
parent993681def8241dcf0af8da1993015e1445f63837 (diff)
downloadsystemd-5c33b6865246f0651ced43048fa1cb58cbc0c35b.tar.gz
repart: Rework Minimize= option settings
Instead of having Minimize= take a boolean let's allow for two different ways to enable it. "best" means we want the most minimal image possible, which currently is only possible for read-only filesystems but can be extended in the future with bisection to find the most minimal possible size. We also add "guess", which is the current behavior, where we populate once and use the sparse size to make a reasonable guess on a size that fits all the sources without needing to O(log(n)) tries to find the most minimal size.
Diffstat (limited to 'man/repart.d.xml')
-rw-r--r--man/repart.d.xml15
1 files changed, 10 insertions, 5 deletions
diff --git a/man/repart.d.xml b/man/repart.d.xml
index d5ce3f8587..1da38a4e91 100644
--- a/man/repart.d.xml
+++ b/man/repart.d.xml
@@ -590,11 +590,16 @@
<varlistentry>
<term><varname>Minimize=</varname></term>
- <listitem><para>Takes a boolean. Disabled by default. If enabled, the partition is created at least
- as big as required for the minimal file system of the type specified by <varname>Format=</varname>,
- taking into account the sources configured with <varname>CopyFiles=</varname>. Note that unless the
- filesystem is a read-only filesystem, <command>systemd-repart</command> will have to populate the
- filesystem twice, so enabling this option might slow down repart when populating large partitions.
+ <listitem><para>Takes one of <literal>off</literal>, <literal>best</literal>, and
+ <literal>guess</literal> (alternatively, also accepts a boolean value, which is mapped to
+ <literal>off</literal> when false, and <literal>best</literal> when true). Defaults to
+ <literal>off</literal>. If set to <literal>best</literal>, the partition will have the minimal size
+ required to store the sources configured with <varname>CopyFiles=</varname>. <literal>best</literal>
+ is currently only supported for read-only filesystems. If set to <literal>guess</literal>, the
+ partition is created at least as big as required to store the sources configured with
+ <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>
</varlistentry>
</variablelist>