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 OPTIONS IMAGE + + systemd-dissect OPTIONS IMAGE COMMAND + systemd-dissect OPTIONS IMAGE PATH TARGET @@ -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 +