From: Lennart Poettering <lennart@poettering.net>
Date: Thu, 17 Sep 2020 16:00:26 +0000 (+0200)
Subject: man: emphasize that part table shown by systemd-dissect is not complete
X-Git-Tag: v247-rc1~198^2~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=461836a4e9db75453045a96f2bafb9ce19b34e68;p=thirdparty%2Fsystemd.git

man: emphasize that part table shown by systemd-dissect is not complete
---

diff --git a/man/systemd-dissect.xml b/man/systemd-dissect.xml
index 55e7076b43a..a2e77281c8d 100644
--- a/man/systemd-dissect.xml
+++ b/man/systemd-dissect.xml
@@ -74,6 +74,15 @@
     <option>--image=</option> switch, and be used as root file system for system service using the
     <varname>RootImage=</varname> unit file setting, see
     <citerefentry><refentrytitle>system.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+
+    <para>Note that the partition table shown when invoked without command switch (as listed below) does not
+    necessarily show all partitions included in the image, but just the partitions that are understood and
+    considered part of an OS disk image. Specifically, partitions of unknown types are ignored, as well as
+    duplicate partitions (i.e. more than one per partition type), as are root and <filename>/usr/</filename>
+    partitions of architectures not compatible with the local system. In other words: this tool will display
+    what it operates with when mounting the image. To display the complete list of partitions use a tool such
+    as <citerefentry
+    project='man-pages'><refentrytitle>fdisk</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
   </refsect1>
 
   <refsect1>
@@ -246,7 +255,8 @@
       <citerefentry><refentrytitle>system-nspawn</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
       <citerefentry><refentrytitle>system.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
       <ulink url="https://systemd.io/DISCOVERABLE_PARTITIONS">Discoverable Partitions Specification</ulink>,
-      <citerefentry project='man-pages'><refentrytitle>umount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+      <citerefentry project='man-pages'><refentrytitle>umount</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+      <citerefentry project='man-pages'><refentrytitle>fdisk</refentrytitle><manvolnum>8</manvolnum></citerefentry>
     </para>
   </refsect1>