summaryrefslogtreecommitdiff
path: root/man/systemd-dissect.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2022-11-09 12:12:02 +0100
committerLennart Poettering <lennart@poettering.net>2022-11-09 22:20:51 +0100
commitb5b40106c7a733d8a88268a91fd08a2edb395cae (patch)
treed042fd54aba70e31972d02dd1ef4b794bc755659 /man/systemd-dissect.xml
parentdb02190eec6fc2d2d9a0cde3a43e957ab0fd3977 (diff)
downloadsystemd-b5b40106c7a733d8a88268a91fd08a2edb395cae.tar.gz
man: document new systemd-dissect --mtree switch
Diffstat (limited to 'man/systemd-dissect.xml')
-rw-r--r--man/systemd-dissect.xml20
1 files changed, 20 insertions, 0 deletions
diff --git a/man/systemd-dissect.xml b/man/systemd-dissect.xml
index f857ecacc7..0b6bf793ce 100644
--- a/man/systemd-dissect.xml
+++ b/man/systemd-dissect.xml
@@ -35,6 +35,9 @@
<command>systemd-dissect <arg choice="opt" rep="repeat">OPTIONS</arg> <option>--list</option> <arg choice="plain"><replaceable>IMAGE</replaceable></arg></command>
</cmdsynopsis>
<cmdsynopsis>
+ <command>systemd-dissect <arg choice="opt" rep="repeat">OPTIONS</arg> <option>--mtree</option> <arg choice="plain"><replaceable>IMAGE</replaceable></arg></command>
+ </cmdsynopsis>
+ <cmdsynopsis>
<command>systemd-dissect <arg choice="opt" rep="repeat">OPTIONS</arg> <option>--with</option> <arg choice="plain"><replaceable>IMAGE</replaceable></arg> <arg choice="opt" rep="repeat"><replaceable>COMMAND</replaceable></arg></command>
</cmdsynopsis>
<cmdsynopsis>
@@ -164,6 +167,23 @@
</varlistentry>
<varlistentry>
+ <term><option>--mtree</option></term>
+ <term><option>-l</option></term>
+
+ <listitem><para>Generates a BSD <citerefentry
+ project='die-net'><refentrytitle>mtree</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+ compatible file manifest of the specified disk image. This is useful for comparing disk image
+ contents in detail, including inode information and other metadata. While the generated manifest will
+ contain detailed inode information, it currently excludes extended attributes, file system
+ capabilities, MAC labels, <citerefentry
+ project='man-pages'><refentrytitle>chattr</refentrytitle><manvolnum>1</manvolnum></citerefentry> file
+ flags, btrfs subvolume information, and various other file metadata. File content information is
+ shown via a SHA256 digest. Additional fields might be added in future. Note that inode information
+ such as link counts, inode numbers and timestamps is excluded from the output on purpose, as it
+ typically complicates reproducibility.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>--with</option></term>
<listitem><para>Runs the specified command with the specified OS image mounted. This will mount the