man: document new systemd-dissect --mtree switch

This commit is contained in:
Lennart Poettering
2022-11-09 12:12:02 +01:00
parent db02190eec
commit b5b40106c7

View File

@@ -34,6 +34,9 @@
<cmdsynopsis>
<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>
@@ -163,6 +166,23 @@
standard output.</para></listitem>
</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>