> systemd-dissect [OPTION…] IMAGE
> systemd-dissect [OPTION…] --mount IMAGE PATH
> systemd-dissect [OPTION…] --umount PATH
> systemd-dissect [OPTION…] --attach IMAGE
> systemd-dissect [OPTION…] --detach PATH
> systemd-dissect [OPTION…] --list IMAGE
> systemd-dissect [OPTION…] --mtree IMAGE
> systemd-dissect [OPTION…] --with IMAGE [COMMAND…]
> systemd-dissect [OPTION…] --copy-from IMAGE PATH [TARGET]
> systemd-dissect [OPTION…] --copy-to IMAGE [SOURCE] PATH
> systemd-dissect [OPTION…] --make-archive IMAGE [TARGET]
> systemd-dissect [OPTION…] --discover
> systemd-dissect [OPTION…] --validate IMAGE
> systemd-dissect [OPTION…] --shift IMAGE UIDBASE
Dissect a Discoverable Disk Image (DDI).
Options:
--no-pager Do not start a pager
--no-legend Do not show headers and footers
--mkdir Make mount directory before mounting, if missing
--rmdir Remove mount directory after unmounting
-r --read-only Mount read-only
--discard=MODE Choose discard mode (disabled, loop, all, crypto)
--in-memory Copy image into memory
--root-hash=HASH Specify root hash for verity
--usr-hash=HASH Same, but for the usr partition
--root-hash-sig=SIG Specify signature of root hash for verity as DER-encoded PKCS7, either as
a path to a file or as an ASCII base64-encoded string prefixed by
'base64:'
--usr-hash-sig=SIG Same, but for the usr partition
--verity-data=PATH Specify data file with hash tree for verity if it is not embedded in
IMAGE
--fsck=BOOL Run fsck before mounting
--growfs=BOOL Grow file system to partition size, if marked
--json=FORMAT Generate JSON output (pretty, short, or off)
--loop-ref=NAME Set reference string for loopback device
--loop-ref-auto Derive reference string from image file name
--image-policy=POLICY Specify image dissection policy
--mtree-hash=BOOL Whether to include SHA256 hash in the mtree output
--system Discover system images
--user Discover user images
--all Show hidden images too
-q --quiet Suppress output of chosen loopback block device
--image-filter=FILTER Specify image dissection filter
--copy-ownership=BOOL Whether to copy ownership when copying files
Commands:
-h --help Show this help
--version Show package version
-m --mount Mount the image to the specified directory
-M Shortcut for --mount --mkdir
-u --umount Unmount the image from the specified directory
-U Shortcut for --umount --rmdir
--attach Attach the disk image to a loopback block device
--detach Detach a loopback block device again
-l --list List all the files and directories of the specified OS image
--mtree Show BSD mtree manifest of OS image
--with Mount, run command, unmount
-x --copy-from Copy files from image to host
-a --copy-to Copy files from host to image
--make-archive Convert the DDI to an archive file
--discover Discover DDIs in well known directories
--validate Validate image and image policy
--shift Shift UID range to selected base
See the systemd-dissect(1) man page for details.
Options (39)
| Option | Description | Source |
|---|---|---|
--no-pager | Do not start a pager | help |
--no-legend | Do not show headers and footers | help |
--mkdir | Make mount directory before mounting, if missing | help |
--rmdir | Remove mount directory after unmounting | help |
-r --read-only | Mount read-only | help |
--discard MODE | Choose discard mode (disabled, loop, all, crypto) | help |
--in-memory | Copy image into memory | help |
--root-hash HASH | Specify root hash for verity | help |
--usr-hash HASH | Same, but for the usr partition | help |
--root-hash-sig SIG | Specify signature of root hash for verity as DER-encoded PKCS7, either as a path to a file or as an ASCII base64-encoded string prefixed by 'base64:' | help |
--usr-hash-sig SIG | Same, but for the usr partition | help |
--verity-data PATH | Specify data file with hash tree for verity if it is not embedded in IMAGE | help |
--fsck BOOL | Run fsck before mounting | help |
--growfs BOOL | Grow file system to partition size, if marked | help |
--json FORMAT | Generate JSON output (pretty, short, or off) | help |
--loop-ref NAME | Set reference string for loopback device | help |
--loop-ref-auto | Derive reference string from image file name | help |
--mtree-hash BOOL | Whether to include SHA256 hash in the mtree output | help |
--system | Discover system images | help |
--user | Discover user images | help |
--all | Show hidden images too | help |
-q --quiet | Suppress output of chosen loopback block device | help |
-h --help | Show this help | help |
--version | Show package version | help |
-m --mount | Mount the image to the specified directory | help |
-M | Shortcut for --mount --mkdir | help |
-u --umount | Unmount the image from the specified directory | help |
-U | Shortcut for --umount --rmdir | help |
--attach | Attach the disk image to a loopback block device | help |
--detach | Detach a loopback block device again | help |
-l --list | List all the files and directories of the specified OS image | help |
--mtree | Show BSD mtree manifest of OS image | help |
--with | Mount, run command, unmount | help |
-x --copy-from | Copy files from image to host | help |
-a --copy-to | Copy files from host to image | help |
--make-archive | Convert the DDI to an archive file | help |
--discover | Discover DDIs in well known directories | help |
--validate | Validate image and image policy | help |
--shift | Shift UID range to selected base | help |