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

@ -1334,21 +1334,29 @@ One may determine the ability for Jigdo by:
.template file contains the compressed ISO image with reference tags
instead of the content bytes of the listed files.
Input for this process are the normal arguments for a 'xorrisofs'
session with no image loaded, and a .md5 file which lists those data
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:
MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2
in the .template file. Each designated file is represented in the
checksum file by a single text line:
Checksum as hex digits, 2 blanks, size as 12 decimal digits or blanks, 2
blanks, symbolic file address
The file address in an .md5 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
file. Jigdo restore tools will convert these addresses into really
reachable data source addresses from which they can read.
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".
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 file. Jigdo restore tools will convert these addresses into
really reachable data source addresses from which they can read.
If the list of jigdo parameters is not empty, then padding will be
counted as part of the ISO image.
-jigdo-checksum-algorithm "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".
-jigdo-jigdo disk_path
Set the disk_path for the .jigdo file with the checksums and
download addresses for filling the holes in .template.
@ -1360,12 +1368,14 @@ counted as part of the ISO image.
file and being a hole in the .template file. 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).
-jigdo-force-md5 disk_path_pattern
-jigdo-force-checksum 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 program run but finally causes a non-zero exit value of the
program.
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.
-jigdo-force-md5 disk_path_pattern
Outdated alias of -jigdo-force-checksum.
-jigdo-exclude 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
@ -1373,13 +1383,17 @@ counted as part of the ISO image.
-jigdo-map 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 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.
the 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.
-checksum-list disk_path
Set the disk_path where to find the checksum file file with
symbolic file addresses and checksums according to
-jigdo-checksum-algorithm.
-md5-list disk_path
Set the disk_path where to find the .md5 input file.
Outdated alias of -checksum-list.
-jigdo-template-compress "gzip"|"bzip2"
Choose one of "bzip2" or "gzip" for the compression of the template
file. The jigdo file is put out uncompressed.
@ -2011,9 +2025,10 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -C set load address and write address offset: Loading. (line 25)
* -cdrecord-params set load address and write address offset: Loading.
(line 41)
* -checksum_algorithm_iso choose .jigdo checksums: Jigdo. (line 72)
* -checksum-list set path of input checksum file: Jigdo. (line 77)
* -checksum_algorithm_iso choose .jigdo checksums: Jigdo. (line 86)
* -checksum_algorithm_template choose .template checksums: Jigdo.
(line 78)
(line 92)
* -chrp-boot CHRP partition: SystemArea. (line 267)
* -chrp-boot-part CHRP partition: SystemArea. (line 258)
* -copyright set Copyright File path: ImageId. (line 66)
@ -2089,14 +2104,20 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -iso_mbr_part_type Set type of ISO MBR partition: SystemArea.
(line 127)
* -J enable production of Joliet directory tree: SetExtras. (line 147)
* -jigdo-exclude add exclusion pattern for .md5: Jigdo. (line 55)
* -jigdo-force-md5 add check pattern for .md5: Jigdo. (line 49)
* -jigdo-jigdo set name of .jigdo file: Jigdo. (line 38)
* -jigdo-map add address translation for .jigdo: Jigdo. (line 59)
* -jigdo-min-file-size set minimum extract size: Jigdo. (line 44)
* -jigdo-template set name of .template file: Jigdo. (line 41)
* -jigdo-checksum-algorithm set data file checksum algorithm: Jigdo.
(line 42)
* -jigdo-exclude add exclusion pattern for checksum file: Jigdo.
(line 65)
* -jigdo-force-checksum add check pattern for checksum file: Jigdo.
(line 57)
* -jigdo-force-md5 add check pattern for checksum file: Jigdo.
(line 63)
* -jigdo-jigdo set name of .jigdo file: Jigdo. (line 46)
* -jigdo-map add address translation for .jigdo: Jigdo. (line 69)
* -jigdo-min-file-size set minimum extract size: Jigdo. (line 52)
* -jigdo-template set name of .template file: Jigdo. (line 49)
* -jigdo-template-compress choose compression algorithm: Jigdo.
(line 69)
(line 83)
* -joliet enable production of Joliet directory tree: SetExtras.
(line 151)
* -joliet-long allow longer Joliet names: SetExtras. (line 153)
@ -2107,7 +2128,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -M set path for loading existing ISO image: Loading. (line 11)
* -max-iso9660-filenames allow 37 characters in ISO file names: SetCompl.
(line 61)
* -md5-list set path of readable .md5: Jigdo. (line 67)
* -md5-list set path of input checksum file: Jigdo. (line 81)
* -mips-boot MIPS Big Endian boot image: SystemArea. (line 274)
* -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 280)
* -N omit version number in ISO file names: SetCompl. (line 64)
@ -2330,17 +2351,21 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* ISO level, specify, -iso-level <1>: SetCompl. (line 8)
* ISO root directory, redirect, -root: SetInsert. (line 55)
* iso_rr_path, _definition: Insert. (line 8)
* Jigdo Template Extraction, -checksum_algorithm_iso: Jigdo. (line 72)
* Jigdo Template Extraction, -checksum-list: Jigdo. (line 77)
* Jigdo Template Extraction, -checksum_algorithm_iso: Jigdo. (line 86)
* Jigdo Template Extraction, -checksum_algorithm_template: Jigdo.
(line 78)
* Jigdo Template Extraction, -jigdo-exclude: Jigdo. (line 55)
* Jigdo Template Extraction, -jigdo-force-md5: Jigdo. (line 49)
* Jigdo Template Extraction, -jigdo-jigdo: Jigdo. (line 38)
* Jigdo Template Extraction, -jigdo-map: Jigdo. (line 59)
* Jigdo Template Extraction, -jigdo-min-file-size: Jigdo. (line 44)
* Jigdo Template Extraction, -jigdo-template: Jigdo. (line 41)
* Jigdo Template Extraction, -jigdo-template-compress: Jigdo. (line 69)
* Jigdo Template Extraction, -md5-list: Jigdo. (line 67)
(line 92)
* Jigdo Template Extraction, -jigdo-checksum-algorithm: Jigdo.
(line 42)
* Jigdo Template Extraction, -jigdo-exclude: Jigdo. (line 65)
* Jigdo Template Extraction, -jigdo-force-checksum: Jigdo. (line 57)
* Jigdo Template Extraction, -jigdo-force-md5: Jigdo. (line 63)
* Jigdo Template Extraction, -jigdo-jigdo: Jigdo. (line 46)
* Jigdo Template Extraction, -jigdo-map: Jigdo. (line 69)
* Jigdo Template Extraction, -jigdo-min-file-size: Jigdo. (line 52)
* Jigdo Template Extraction, -jigdo-template: Jigdo. (line 49)
* Jigdo Template Extraction, -jigdo-template-compress: Jigdo. (line 83)
* Jigdo Template Extraction, -md5-list: Jigdo. (line 81)
* Jigdo Template Extraction, _definition: Jigdo. (line 6)
* Joliet, allows longer names, -joliet-long: SetExtras. (line 153)
* Joliet, enable, -J, -joliet: SetExtras. (line 147)
@ -2418,21 +2443,21 @@ Node: Bootable38983
Node: SystemArea45269
Node: Charset63501
Node: Jigdo64526
Node: Miscellaneous68803
Node: Examples70448
Node: ExSimple70942
Node: ExGraft71425
Node: ExMkisofs72725
Node: ExGrowisofs74533
Node: ExIncBackup75723
Node: ExIncBckAcc78899
Node: ExBootable80604
Node: Files84786
Node: Environ85881
Node: Seealso86754
Node: Bugreport87405
Node: Legal87998
Node: CommandIdx88895
Node: ConceptIdx104763
Node: Miscellaneous69496
Node: Examples71141
Node: ExSimple71635
Node: ExGraft72118
Node: ExMkisofs73418
Node: ExGrowisofs75226
Node: ExIncBackup76416
Node: ExIncBckAcc79592
Node: ExBootable81297
Node: Files85479
Node: Environ86574
Node: Seealso87447
Node: Bugreport88098
Node: Legal88691
Node: CommandIdx89588
Node: ConceptIdx105940

End Tag Table