Switched to usage of libjte-2.0.0. New -jigdo parameters "checksum_algorithm", "demand_checksum", "checksum_path". New -as mkisofs options-jigdo-checksum-algorithm, "-checksum-list", "-jigdo-force-checksum".

This commit is contained in:
2019-11-24 13:34:30 +01:00
parent c4894d8ae3
commit 1557304c96
12 changed files with 326 additions and 182 deletions

View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH XORRISOFS 1 "Version 1.5.3, Oct 28, 2019"
.TH XORRISOFS 1 "Version 1.5.3, Nov 23, 2019"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -1529,15 +1529,20 @@ The .template file contains the compressed ISO image with reference tags
instead of the content bytes of the listed files.
.br
Input for this process are the normal arguments for a \fBxorrisofs\fR
session
with no image loaded, and a .md5 file which lists those data files which may be
session with no image loaded, and a checksum file which lists those
data files which may be
listed in the .jigdo file and externally referenced in the .template file.
Each designated file is represented in the .md5 file by a single text line:
Each designated file is represented in the checksum file by a single text line:
.br
MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 blanks,
Checksum as hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 blanks,
symbolic file address
.br
The file address in an .md5 line has to bear the same basename as the
The kind of checksum is chosen by \-jigdo "checksum_algorithm" with values "md5"
(32 hex digits) or "sha256" (64 hex digits).
It will also be used for the file address lines in the .jigdo file.
The default is "md5".
.br
The file address in a checksum file line has to bear the same basename as the
disk_path of the file which it shall match. The directory path of
the file address is decisive for To=From mapping, not for file recognition.
After To=From mapping, the file address gets written into the .jigdo
@ -1548,6 +1553,10 @@ If the list of jigdo parameters is not empty, then padding will be
counted as part of the ISO image.
.br
.TP
\fB\-jigdo-checksum-algorithm\fR "md5"|"sha256"
Set the checksum algorithm which shall be used for the data file entries
in the .jigdo file and is expected in the checksum file. Default is "md5".
.TP
\fB\-jigdo-jigdo\fR disk_path
Set the disk_path for the .jigdo file with the checksums
and download addresses for filling the holes in .template.
@ -1563,12 +1572,16 @@ size may be a plain number counting bytes, or a number with appended
letter "k", "m", "g" to count KiB (1024 bytes), MiB (1024 KiB), or
GiB (1024 MiB).
.TP
\fB\-jigdo-force-md5\fR disk_path_pattern
\fB\-jigdo-force-checksum\fR disk_path_pattern
adds a regular expression pattern which will get compared
with the absolute disk_path of any data file that was not found in the .md5
list. A match causes a MISHAP event, which normally does not abort the
with the absolute disk_path of any data file that was not found in the
checksum file.
A match causes a MISHAP event, which normally does not abort the
program run but finally causes a non\-zero exit value of the program.
.TP
\fB\-jigdo-force-md5\fR disk_path_pattern
Outdated alias of \-jigdo\-force\-checksum.
.TP
\fB\-jigdo-exclude\fR disk_path_pattern
Add a regular expression pattern which will get compared
with the absolute disk_path of any data file. A match causes the file to
@ -1577,13 +1590,17 @@ stay in .template in any case.
\fB\-jigdo-map\fR To=From
Add a string pair of the form To=From to the parameter list.
If a data file gets listed in the .jigdo file, then it is referred by the
file address from its line in the .md5 file. This file address gets checked
file address from its line in the checksum file. This file address gets checked
whether it begins with the From string. If so, then this string will be
replaced by the To string and a ':' character, before it goes into the .jigdo
file. The From string should end by a '/' character.
.TP
\fB\-checksum-list\fR disk_path
Set the disk_path where to find the checksum file file with
symbolic file addresses and checksums according to \-jigdo\-checksum\-algorithm.
.TP
\fB\-md5-list\fR disk_path
Set the disk_path where to find the .md5 input file.
Outdated alias of \-checksum\-list.
.TP
\fB\-jigdo-template-compress\fR "gzip"|"bzip2"
Choose one of "bzip2" or "gzip" for the compression of