1 files changed, 61 insertions, 34 deletions
diff --git a/upstream/fedora-rawhide/man1/systemd-dissect.1 b/upstream/fedora-rawhide/man1/systemd-dissect.1
index 994c72a0..c8b6a286 100644
--- a/upstream/fedora-rawhide/man1/systemd-dissect.1
+++ b/upstream/fedora-rawhide/man1/systemd-dissect.1
@@ -1,5 +1,5 @@
 '\" t
-.TH "SYSTEMD\-DISSECT" "1" "" "systemd 255" "systemd-dissect"
+.TH "SYSTEMD\-DISSECT" "1" "" "systemd 256~rc3" "systemd-dissect"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -22,30 +22,32 @@
 .SH "NAME"
 systemd-dissect, mount.ddi \- Dissect Discoverable Disk Images (DDIs)
 .SH "SYNOPSIS"
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fIIMAGE\fR\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-mount\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-mount\fR\fR\fB \fR\fB\fIIMAGE\fR\fR\fB \fR\fB\fIPATH\fR\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-umount\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-umount\fR\fR\fB \fR\fB\fIPATH\fR\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-attach\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-attach\fR\fR\fB \fR\fB\fIIMAGE\fR\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-detach\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-detach\fR\fR\fB \fR\fB\fIPATH\fR\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-list\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-list\fR\fR\fB \fR\fB\fIIMAGE\fR\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-mtree\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-mtree\fR\fR\fB \fR\fB\fIIMAGE\fR\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-with\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB[\fICOMMAND\fR...]\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-with\fR\fR\fB \fR\fB\fIIMAGE\fR\fR\fB \fR\fB[\fICOMMAND\fR...]\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-copy\-from\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\fB\ \fR\fB[\fITARGET\fR]\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-copy\-from\fR\fR\fB \fR\fB\fIIMAGE\fR\fR\fB \fR\fB\fIPATH\fR\fR\fB \fR\fB[\fITARGET\fR]\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-copy\-to\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB[\fISOURCE\fR]\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-copy\-to\fR\fR\fB \fR\fB\fIIMAGE\fR\fR\fB \fR\fB[\fISOURCE\fR]\fR\fB \fR\fB\fIPATH\fR\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-discover\fR\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-discover\fR\fR
-.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-validate\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u
-\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-validate\fR\fR\fB \fR\fB\fIIMAGE\fR\fR
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] \fIIMAGE\fR
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-mount] \fIIMAGE\fR \fIPATH\fR
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-umount] \fIPATH\fR
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-attach] \fIIMAGE\fR
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-detach] \fIPATH\fR
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-list] \fIIMAGE\fR
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-mtree] \fIIMAGE\fR
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-with] \fIIMAGE\fR [\fICOMMAND\fR...]
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-copy\-from] \fIIMAGE\fR \fIPATH\fR [\fITARGET\fR]
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-copy\-to] \fIIMAGE\fR [\fISOURCE\fR] \fIPATH\fR
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-make\-archive] \fIIMAGE\fR [\fITARGET\fR]
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-discover]
+.HP \w'\fBsystemd\-dissect\fR\ 'u
+\fBsystemd\-dissect\fR [OPTIONS...] [\-\-validate] \fIIMAGE\fR
 .SH "DESCRIPTION"
 .PP
 \fBsystemd\-dissect\fR
@@ -158,6 +160,12 @@ can be mounted directly by
 \fBmount\fR
 and
 \fBfstab\fR(5)\&. For details see below\&.
+.PP
+In place of the image path a
+"\&.v/"
+versioned directory may be specified, see
+\fBsystemd.v\fR(7)
+for details\&.
 .SH "COMMANDS"
 .PP
 If neither of the command switches listed below are passed the specified disk image is opened and general information about the image and the contained partitions and their use is shown\&.
@@ -282,6 +290,17 @@ file system checks are implicitly run before the copy operation begins\&.
 Added in version 247\&.
 .RE
 .PP
+\fB\-\-make\-archive\fR
+.RS 4
+Generates an archive file from the specified disk image\&. Expects two arguments: the path to the disk image and optionally the output archive file path\&. If the latter is omitted the archive is written to standard output\&. The archive file format is determined automatically from the specified output archive file name, e\&.g\&. any path suffixed with
+"\&.tar\&.xz"
+will result in an xz compressed UNIX tarball (if the path is omitted an uncompressed UNIX tarball is created)\&. See
+\fBlibarchive\fR(3)
+for a list of supported archive formats and compression schemes\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
 \fB\-\-discover\fR
 .RS 4
 Show a list of DDIs in well\-known directories\&. This will show machine, portable service and system/configuration extension disk images in the usual directories
@@ -525,7 +544,7 @@ Do not pipe output into a pager\&.
 Do not print the legend, i\&.e\&. column headers and the footer with hints\&.
 .RE
 .PP
-\fB\-\-json=\fR\fIMODE\fR
+\fB\-\-json=\fR\fB\fIMODE\fR\fR
 .RS 4
 Shows output formatted as JSON\&. Expects one of
 "short"
@@ -601,7 +620,7 @@ map to the corresponding options listed above (i\&.e\&.
 generically passed on to the file systems inside the images\&.
 .SH "EXAMPLES"
 .PP
-\fBExample\ \&1.\ \&Generate a tarball from an OS disk image\fR
+\fBExample\ \&1.\ \&Generate a tarball from an OS disk image (\-\-with)\fR
 .sp
 .if n \{\
 .RS 4
@@ -612,15 +631,23 @@ generically passed on to the file systems inside the images\&.
 .if n \{\
 .RE
 .\}
+.PP
+or alternatively just:
+.PP
+\fBExample\ \&2.\ \&Generate a tarball from an OS disk image (\-\-make\-archive)\fR
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+# systemd\-dissect \-\-make\-archive foo\&.raw foo\&.tar\&.gz
+.fi
+.if n \{\
+.RE
+.\}
 .SH "SEE ALSO"
 .PP
-\fBsystemd\fR(1),
-\fBsystemd-nspawn\fR(1),
-\fBsystemd.exec\fR(5),
-\m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2,
-\fBmount\fR(8),
-\fBumount\fR(8),
-\fBfdisk\fR(8)
+\fBsystemd\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd.exec\fR(5), \fBsystemd.v\fR(7), \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2, \fBmount\fR(8), \fBumount\fR(8), \fBfdisk\fR(8)
 .SH "NOTES"
 .IP " 1." 4
 Discoverable Partitions Specification