diff --git a/man/systemd-dissect.xml b/man/systemd-dissect.xml
index 955909ff91..f857ecacc7 100644
--- a/man/systemd-dissect.xml
+++ b/man/systemd-dissect.xml
@@ -34,6 +34,9 @@
systemd-dissect OPTIONSIMAGE
+
+ systemd-dissect OPTIONSIMAGECOMMAND
+ systemd-dissect OPTIONSIMAGEPATHTARGET
@@ -160,6 +163,19 @@
standard output.
+
+
+
+ Runs the specified command with the specified OS image mounted. This will mount the
+ image to a temporary directory, switch the current working directory to it, and invoke the specified
+ command line as child process. Once the process ends it will unmount the image again, and remove the
+ temporary directory. If no command is specified a shell is invoked. The image is mounted writable,
+ use to switch to read-only operation. The invoked process will have the
+ $SYSTEMD_DISSECT_ROOT environment variable set, containing the absolute path name
+ of the temporary mount point, i.e. the same directory that is set as the current working
+ directory.
+
+
@@ -294,14 +310,24 @@
-
Exit status
- On success, 0 is returned, a non-zero failure code
- otherwise.
+ On success, 0 is returned, a non-zero failure code otherwise. If the
+ command is used the exit status of the invoked command is propagated.
+
+
+
+
+ Examples
+
+
+ Generate a tarball from an OS disk image
+
+ $ systemd-dissect --with foo.raw tar cz . > foo.tar.gz
+