summaryrefslogtreecommitdiff
path: root/man/systemd-repart.xml
diff options
context:
space:
mode:
authorDaan De Meyer <daan.j.demeyer@gmail.com>2022-09-19 16:58:20 +0200
committerDaan De Meyer <daan.j.demeyer@gmail.com>2022-09-22 15:10:03 +0200
commit4cee83331c3071925b1b8d70dea8d365275a2c8e (patch)
treeb9b76e731b5990c4251ca1be01b72ca2cbaddd2b /man/systemd-repart.xml
parent1e58a0a82ca309112016dfa8793f3c37a31d93e9 (diff)
downloadsystemd-4cee83331c3071925b1b8d70dea8d365275a2c8e.tar.gz
repart: Add --split option to generate split artifacts
For use with sysupdate or other systemd tooling, it's useful to be able to generate split artifacts from disk images, where each partition is written to a separate file. Let's support this with a --split switch for repart and a SplitName= configuration option. --split enables split artifacts generation, and SplitName= configures for which partition to generate split artifacts, and which suffix to add to the split artifact name. For SplitName=, we add support for some extra specifiers, more specifically the partition Type UUID and the partition UUID.
Diffstat (limited to 'man/systemd-repart.xml')
-rw-r--r--man/systemd-repart.xml15
1 files changed, 15 insertions, 0 deletions
diff --git a/man/systemd-repart.xml b/man/systemd-repart.xml
index 236058b74c..6a7aa21c66 100644
--- a/man/systemd-repart.xml
+++ b/man/systemd-repart.xml
@@ -332,6 +332,21 @@
for details on these two options.</para></listitem>
</varlistentry>
+ <varlistentry>
+ <term><option>--split=</option><arg>BOOL</arg></term>
+
+ <listitem><para>Enables generation of split artifacts from partitions configured with
+ <varname>SplitName=</varname>. If enabled, for each partition with <varname>SplitName=</varname> set,
+ a separate output file containing just the contents of that partition is generated. The output
+ filename consists of the loopback filename suffixed with the name configured with
+ <varname>SplitName=</varname>. If the loopback filename ends with <literal>.raw</literal>, the suffix
+ is inserted before the <literal>.raw</literal> extension instead.</para>
+
+ <para>Note that <option>--split</option> is independent from <option>--dry-run</option>. Even if
+ <option>--dry-run</option> is enabled, split artifacts will still be generated from an existing image
+ if <option>--split</option> is enabled.</para></listitem>
+ </varlistentry>
+
<xi:include href="standard-options.xml" xpointer="help" />
<xi:include href="standard-options.xml" xpointer="version" />
<xi:include href="standard-options.xml" xpointer="no-pager" />