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 XORRISO 1 "Version 1.5.3, Oct 28, 2019"
.TH XORRISO 1 "Version 1.5.3, Nov 23, 2019"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -3772,14 +3772,19 @@ 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 \fBxorriso\fR session
on a blank \-outdev, and a .md5 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:
on a blank \-outdev, 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 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
@ -3801,6 +3806,12 @@ emulation command.
Parameter \fBclear\fR with any value empties the whole list.
No .jigdo and .template file will be produced.
.br
\fBchecksum_algorithm\fR chooses the checksum algorithm which shall be used
for the data file entries in the .jigdo file and is expected in the checksum
file. Permissible are "md5" or "sha256". Default is "md5".
.br
Alias: \-jigdo\-checksum\-algorithm
.br
\fBtemplate_path\fR sets the disk_path for the .template file with the
holed and compressed ISO image copy.
.br
@ -3811,7 +3822,12 @@ and download addresses for filling the holes in .template.
.br
Alias: \-jigdo\-jigdo
.br
\fBmd5_path\fR sets the disk_path where to find the .md5 input file.
\fBchecksum_path\fR sets the disk_path where to find the checksum file with
symbolic file addresses and checksums according to \fBchecksum_algorithm\fR.
.br
Alias: md5_path
.br
Alias: \-checksum\-list
.br
Alias: \-md5\-list
.br
@ -3826,15 +3842,19 @@ stay in .template in any case.
.br
Alias: \-jigdo\-exclude
.br
\fBdemand_md5\fR 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.
\fBdemand_checksum\fR adds a regular expression pattern which will get
compared with the absolute disk_path of any data file that was not found
in the checksum list file as of "checksum_path". A match causes a MISHAP event.
.br
Alias: demand_md5
.br
Alias: \-jigdo\-force\-checksum
.br
Alias: \-jigdo\-force\-md5
.br
\fBmapping\fR adds 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.