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:
Thomas Schmitt 2019-11-24 13:34:30 +01:00
parent c4894d8ae3
commit 1557304c96
12 changed files with 326 additions and 182 deletions

View File

@ -37,16 +37,16 @@ dnl Libtool versioning
dnl Generate libisoburn.so.1.x.y dnl Generate libisoburn.so.1.x.y
dnl SONAME will become LT_CURRENT - LT_AGE dnl SONAME will become LT_CURRENT - LT_AGE
dnl dnl
dnl ts B91026 dnl ts B91123
dnl ### This is the release version 1.5.2 = libisoburn.so.1.109.0 dnl ### This is the release version 1.5.2 = libisoburn.so.1.109.0
dnl This is the development version after above stable release dnl This is the development version after above stable release
dnl LT_CURRENT++, LT_AGE++ have not happened yet. dnl ### LT_CURRENT++, LT_AGE++ have not happened yet.
dnl ### LT_CURRENT++, LT_AGE++ has happened meanwhile. dnl LT_CURRENT++, LT_AGE++ has happened meanwhile.
dnl dnl
dnl SONAME = 110 - 109 = 1 . Library name = libisoburn.so.1.109.0 dnl SONAME = 111 - 110 = 1 . Library name = libisoburn.so.1.110.0
LT_RELEASE=$ISOBURN_MAJOR_VERSION.$ISOBURN_MINOR_VERSION LT_RELEASE=$ISOBURN_MAJOR_VERSION.$ISOBURN_MINOR_VERSION
LT_CURRENT=110 LT_CURRENT=111
LT_AGE=109 LT_AGE=110
LT_REVISION=0 LT_REVISION=0
LT_CURRENT_MINUS_AGE=`expr $LT_CURRENT - $LT_AGE` LT_CURRENT_MINUS_AGE=`expr $LT_CURRENT - $LT_AGE`
@ -276,11 +276,11 @@ AC_SUBST(ZLIB_DEF)
dnl ts B00928 dnl ts B00928
AC_ARG_ENABLE(libjte, AC_ARG_ENABLE(libjte,
[ --enable-libjte Enable use of libjte by xorriso, default=yes], [ --enable-libjte Enable use of libjte >= 2.0 by xorriso, default=yes],
, enable_libjte=yes) , enable_libjte=yes)
if test "x$enable_libjte" = xyes; then if test "x$enable_libjte" = xyes; then
LIBJTE_DEF="-DXorriso_with_libjtE" LIBJTE_DEF="-DXorriso_with_libjtE"
AC_CHECK_HEADER(libjte/libjte.h, AC_CHECK_LIB(jte, libjte_new, , LIBJTE_DEF= ), LIBJTE_DEF= ) AC_CHECK_HEADER(libjte/libjte.h, AC_CHECK_LIB(jte, libjte_set_checksum_algorithm, , LIBJTE_DEF= ), LIBJTE_DEF= )
else else
LIBJTE_DEF= LIBJTE_DEF=
fi fi

View File

@ -657,8 +657,10 @@ int Xorriso_genisofs_count_args(struct XorrisO *xorriso, int argc, char **argv,
"-alpha-boot", "-hppa-cmdline", "-hppa-kernel-32", "-hppa-kernel-64", "-alpha-boot", "-hppa-cmdline", "-hppa-kernel-32", "-hppa-kernel-64",
"-hppa-bootloader", "-hppa-ramdisk", "-mips-boot", "-mipsel-boot", "-hppa-bootloader", "-hppa-ramdisk", "-mips-boot", "-mipsel-boot",
"-jigdo-jigdo", "-jigdo-template", "-jigdo-min-file-size", "-jigdo-jigdo", "-jigdo-template", "-jigdo-min-file-size",
"-jigdo-force-md5", "-jigdo-exclude", "-jigdo-map", "-md5-list", "-jigdo-force-md5", "-jigdo-force-checksum",
"-jigdo-template-compress", "-md5-list", "-checksum-list",
"-jigdo-exclude", "-jigdo-map",
"-jigdo-template-compress", "-jigdo-checksum-algorithm",
"-checksum_algorithm_iso", "-checksum_algorithm_template", "-checksum_algorithm_iso", "-checksum_algorithm_template",
"--stdio_sync", "--quoted_path_list", "--efi-boot", "--embedded-boot", "--stdio_sync", "--quoted_path_list", "--efi-boot", "--embedded-boot",
"-isohybrid-mbr", "-e", "-partition_offset", "-partition_hd_cyl", "-isohybrid-mbr", "-e", "-partition_offset", "-partition_hd_cyl",
@ -852,11 +854,16 @@ int Xorriso_genisofs_help(struct XorrisO *xorriso, int flag)
" -jigdo-jigdo FILE Produce a jigdo .jigdo file as well as the .iso", " -jigdo-jigdo FILE Produce a jigdo .jigdo file as well as the .iso",
" -jigdo-template FILE Produce a jigdo .template file as well as the .iso", " -jigdo-template FILE Produce a jigdo .template file as well as the .iso",
" -jigdo-min-file-size SIZE Minimum size for a file to be listed in the jigdo file", " -jigdo-min-file-size SIZE Minimum size for a file to be listed in the jigdo file",
" -jigdo-force-md5 PATTERN Pattern(s) where files MUST match an externally-supplied MD5sum", " -jigdo-force-checksum PTRN Pattern(s) where files MUST match an externally-supplied checksum",
" -jigdo-force-md5 PATTERN Outdated alias of -jigdo-force-checksum",
" -jigdo-exclude PATTERN Pattern(s) to exclude from the jigdo file", " -jigdo-exclude PATTERN Pattern(s) to exclude from the jigdo file",
" -jigdo-map PATTERN1=PATTERN2", " -jigdo-map PATTERN1=PATTERN2",
" Pattern(s) to map paths (e.g. Debian=/mirror/debian)", " Pattern(s) to map paths (e.g. Debian=/mirror/debian)",
" -md5-list FILE File containing MD5 sums of the files that should be checked", " -checksum-list FILE File containing checksums of the files that should be checked",
" -md5-list FILE Outdated alias of -checksum-list",
" -jigdo-checksum-algorithm ALGORITHM",
" Choose algorithm for file matching checksums: md5, sha256",
" Expected in the -checksum-list FILE, written into .jigdo file.",
" -jigdo-template-compress ALGORITHM", " -jigdo-template-compress ALGORITHM",
" Choose to use gzip or bzip2 compression for template data; default is gzip", " Choose to use gzip or bzip2 compression for template data; default is gzip",
" -checksum_algorithm_iso alg1,alg2,...", " -checksum_algorithm_iso alg1,alg2,...",
@ -2097,11 +2104,14 @@ not_enough_args:;
strcmp(argpt, "-jigdo-min-file-size") == 0 || strcmp(argpt, "-jigdo-min-file-size") == 0 ||
strcmp(argpt, "-jigdo-exclude") == 0 || strcmp(argpt, "-jigdo-exclude") == 0 ||
strcmp(argpt, "-jigdo-force-md5") == 0 || strcmp(argpt, "-jigdo-force-md5") == 0 ||
strcmp(argpt, "-jigdo-force-checksum") == 0 ||
strcmp(argpt, "-jigdo-map") == 0 || strcmp(argpt, "-jigdo-map") == 0 ||
strcmp(argpt, "-jigdo-checksum-algorithm") == 0 ||
strcmp(argpt, "-jigdo-template-compress") == 0 || strcmp(argpt, "-jigdo-template-compress") == 0 ||
strcmp(argpt, "-checksum_algorithm_iso") == 0 || strcmp(argpt, "-checksum_algorithm_iso") == 0 ||
strcmp(argpt, "-checksum_algorithm_template") == 0 || strcmp(argpt, "-checksum_algorithm_template") == 0 ||
strcmp(argpt, "-md5-list") == 0) { strcmp(argpt, "-md5-list") == 0 ||
strcmp(argpt, "-checksum-list") == 0) {
i++; i++;
ret= Xorriso_option_jigdo(xorriso, argpt, argv[i], 0); ret= Xorriso_option_jigdo(xorriso, argpt, argv[i], 0);
if(ret <= 0) if(ret <= 0)

View File

@ -765,8 +765,10 @@ int Xorriso_jigdo_interpreter(struct XorrisO *xorriso, char *aspect, char *arg,
goto jte_failed; goto jte_failed;
xorriso->libjte_params_given|= 8; xorriso->libjte_params_given|= 8;
} else if(strcmp(aspect, "md5_path") == 0 || } else if(strcmp(aspect, "md5_path") == 0 ||
strcmp(aspect, "-md5-list") == 0) { strcmp(aspect, "-md5-list") == 0 ||
ret= libjte_set_md5_path(jte, arg); strcmp(aspect, "checksum_path") == 0 ||
strcmp(aspect, "-checksum-list") == 0) {
ret= libjte_set_checksum_path(jte, arg);
if(ret <= 0) if(ret <= 0)
goto jte_failed; goto jte_failed;
xorriso->libjte_params_given|= 16; xorriso->libjte_params_given|= 16;
@ -802,8 +804,10 @@ int Xorriso_jigdo_interpreter(struct XorrisO *xorriso, char *aspect, char *arg,
goto jte_failed; goto jte_failed;
xorriso->libjte_params_given|= 512; xorriso->libjte_params_given|= 512;
} else if(strcmp(aspect, "demand_md5") == 0 || } else if(strcmp(aspect, "demand_md5") == 0 ||
strcmp(aspect, "-jigdo-force-md5") == 0) { strcmp(aspect, "-jigdo-force-md5") == 0 ||
ret= libjte_add_md5_demand(jte, arg); strcmp(aspect, "demand_checksum") == 0 ||
strcmp(aspect, "-jigdo-force-checksum") == 0) {
ret= libjte_add_checksum_demand(jte, arg);
if(ret <= 0) if(ret <= 0)
goto jte_failed; goto jte_failed;
xorriso->libjte_params_given|= 1024; xorriso->libjte_params_given|= 1024;
@ -813,6 +817,13 @@ int Xorriso_jigdo_interpreter(struct XorrisO *xorriso, char *aspect, char *arg,
if(ret <= 0) if(ret <= 0)
goto jte_failed; goto jte_failed;
xorriso->libjte_params_given|= 2048; xorriso->libjte_params_given|= 2048;
} else if(strcmp(aspect, "checksum_algorithm") == 0 ||
strcmp(aspect, "-jigdo-checksum-algorithm") == 0) {
int ck_size;
ret= libjte_set_checksum_algorithm(jte, arg, &ck_size);
if(ret <= 0)
goto jte_failed;
xorriso->libjte_params_given|= 4096;
} else { } else {
sprintf(xorriso->info_text, "-jigdo: unknown aspect '%s'", aspect); sprintf(xorriso->info_text, "-jigdo: unknown aspect '%s'", aspect);
Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "FAILURE", 0); Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "FAILURE", 0);

View File

@ -1879,6 +1879,7 @@ int Xorriso_option_help(struct XorrisO *xorriso, int flag)
" Opportunity to omit Rock Ridge info. (Do not do it !)", " Opportunity to omit Rock Ridge info. (Do not do it !)",
" -jigdo \"clear\"|\"template_path\"|\"jigdo_path\"|\"md5_path\"", " -jigdo \"clear\"|\"template_path\"|\"jigdo_path\"|\"md5_path\"",
" |\"min_size\"|\"checksum_iso\"|\"checksum_template\"", " |\"min_size\"|\"checksum_iso\"|\"checksum_template\"",
" |\"checksum_path\"|\"demand_checksum\"|\"checksum_algorithm\"",
" |\"compression\"|\"exclude\"|\"demand_md5\"|\"mapping\"", " |\"compression\"|\"exclude\"|\"demand_md5\"|\"mapping\"",
" |\"checksum_iso\"|\"checksum_template\"", " |\"checksum_iso\"|\"checksum_template\"",
" value", " value",

View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" 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. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" 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. instead of the content bytes of the listed files.
.br .br
Input for this process are the normal arguments for a \fBxorriso\fR session 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 on a blank \-outdev, and a checksum file which lists those data files which may
listed in the .jigdo file and externally referenced in the .template file. 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 .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 symbolic file address
.br .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 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. 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 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. Parameter \fBclear\fR with any value empties the whole list.
No .jigdo and .template file will be produced. No .jigdo and .template file will be produced.
.br .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 \fBtemplate_path\fR sets the disk_path for the .template file with the
holed and compressed ISO image copy. holed and compressed ISO image copy.
.br .br
@ -3811,7 +3822,12 @@ and download addresses for filling the holes in .template.
.br .br
Alias: \-jigdo\-jigdo Alias: \-jigdo\-jigdo
.br .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 .br
Alias: \-md5\-list Alias: \-md5\-list
.br .br
@ -3826,15 +3842,19 @@ stay in .template in any case.
.br .br
Alias: \-jigdo\-exclude Alias: \-jigdo\-exclude
.br .br
\fBdemand_md5\fR adds a regular expression pattern which will get compared \fBdemand_checksum\fR adds a regular expression pattern which will get
with the absolute disk_path of any data file that was not found in the .md5 compared with the absolute disk_path of any data file that was not found
list. A match causes a MISHAP event. 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 .br
Alias: \-jigdo\-force\-md5 Alias: \-jigdo\-force\-md5
.br .br
\fBmapping\fR adds a string pair of the form To=From to the parameter list. \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 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 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 replaced by the To string and a ':' character, before it goes into the .jigdo
file. The From string should end by a '/' character. file. The From string should end by a '/' character.

View File

@ -3184,18 +3184,22 @@ symbolic file addresses. The .template file contains the compressed ISO
image with reference tags instead of the content bytes of the listed image with reference tags instead of the content bytes of the listed
files. files.
Input for this process are the normal arguments for a 'xorriso' session Input for this process are the normal arguments for a 'xorriso' session
on a blank -outdev, and a .md5 file which lists those data files which on a blank -outdev, and a checksum file which lists those data files
may be listed in the .jigdo file and externally referenced in the 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 .template file. Each designated file is represented in the checksum
a single text line: file by a single text line:
MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 Checksum as hex digits, 2 blanks, size as 12 decimal digits or blanks, 2
blanks, symbolic file address blanks, symbolic file address
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
disk_path of the file which it shall match. The directory path of the values "md5" (32 hex digits) or "sha256" (64 hex digits). It will also
file address is decisive for To=From mapping, not for file recognition. be used for the file address lines in the .jigdo file. The default is
After To=From mapping, the file address gets written into the .jigdo "md5".
file. Jigdo restore tools will convert these addresses into really The file address in a checksum file line has to bear the same basename
reachable data source addresses from which they can read. 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 'xorriso' will refuse If the list of jigdo parameters is not empty, then 'xorriso' will refuse
to write to non-blank targets, it will disable multi-session emulation, to write to non-blank targets, it will disable multi-session emulation,
and padding will be counted as part of the ISO image. and padding will be counted as part of the ISO image.
@ -3207,6 +3211,11 @@ and padding will be counted as part of the ISO image.
they are recognized by the -as mkisofs emulation command. they are recognized by the -as mkisofs emulation command.
Parameter *clear* with any value empties the whole list. No .jigdo Parameter *clear* with any value empties the whole list. No .jigdo
and .template file will be produced. and .template file will be produced.
*checksum_algorithm* 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".
Alias: -jigdo-checksum-algorithm
*template_path* sets the disk_path for the .template file with the *template_path* sets the disk_path for the .template file with the
holed and compressed ISO image copy. holed and compressed ISO image copy.
Alias: -jigdo-template Alias: -jigdo-template
@ -3214,7 +3223,11 @@ and padding will be counted as part of the ISO image.
checksums and download addresses for filling the holes in checksums and download addresses for filling the holes in
.template. .template.
Alias: -jigdo-jigdo Alias: -jigdo-jigdo
*md5_path* sets the disk_path where to find the .md5 input file. *checksum_path* sets the disk_path where to find the checksum file
with symbolic file addresses and checksums according to
*checksum_algorithm*.
Alias: md5_path
Alias: -checksum-list
Alias: -md5-list Alias: -md5-list
*min_size* sets the minimum size for a data file to be listed in *min_size* sets the minimum size for a data file to be listed in
the .jigdo file and being a hole in the .template file. the .jigdo file and being a hole in the .template file.
@ -3223,17 +3236,20 @@ and padding will be counted as part of the ISO image.
with the absolute disk_path of any data file. A match causes the with the absolute disk_path of any data file. A match causes the
file to stay in .template in any case. file to stay in .template in any case.
Alias: -jigdo-exclude Alias: -jigdo-exclude
*demand_md5* adds a regular expression pattern which will get *demand_checksum* adds a regular expression pattern which will get
compared with the absolute disk_path of any data file that was not compared with the absolute disk_path of any data file that was not
found in the .md5 list. A match causes a MISHAP event. found in the checksum list file as of "checksum_path". A match
causes a MISHAP event.
Alias: demand_md5
Alias: -jigdo-force-checksum
Alias: -jigdo-force-md5 Alias: -jigdo-force-md5
*mapping* adds a string pair of the form To=From to the parameter *mapping* 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 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 referred by the file address from its line in the checksum file.
file address gets checked whether it begins with the From string. This file address gets checked whether it begins with the From
If so, then this string will be replaced by the To string and a ':' string. If so, then this string will be replaced by the To string
character, before it goes into the .jigdo file. The From string and a ':' character, before it goes into the .jigdo file. The From
should end by a '/' character. string should end by a '/' character.
Alias: -jigdo-map Alias: -jigdo-map
*compression* chooses one of "bzip2" or "gzip" for the compression *compression* chooses one of "bzip2" or "gzip" for the compression
of the template file. The jigdo file is put out uncompressed. of the template file. The jigdo file is put out uncompressed.
@ -5408,7 +5424,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -iso_nowtime fixed "now" time for ISO 9660 objects: Loading. * -iso_nowtime fixed "now" time for ISO 9660 objects: Loading.
(line 217) (line 217)
* -iso_rr_pattern controls pattern expansion: Manip. (line 10) * -iso_rr_pattern controls pattern expansion: Manip. (line 10)
* -jigdo clears JTE or or adds parameter to JTE: Jigdo. (line 33) * -jigdo clears JTE or or adds parameter to JTE: Jigdo. (line 37)
* -joliet enables production of Joliet tree: SetWrite. (line 10) * -joliet enables production of Joliet tree: SetWrite. (line 10)
* -launch_frontend starts frontend program at pipes: Frontend. * -launch_frontend starts frontend program at pipes: Frontend.
(line 141) (line 141)
@ -5703,7 +5719,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Interval reader for system area and partitions: Bootable. (line 32) * Interval reader for system area and partitions: Bootable. (line 32)
* ISO 9660, _definition: Model. (line 6) * ISO 9660, _definition: Model. (line 6)
* iso_rr_path, _definition: Insert. (line 7) * iso_rr_path, _definition: Insert. (line 7)
* Jigdo Template Extraction, -jigdo: Jigdo. (line 33) * Jigdo Template Extraction, -jigdo: Jigdo. (line 37)
* Jigdo Template Extraction, _definition: Jigdo. (line 6) * Jigdo Template Extraction, _definition: Jigdo. (line 6)
* LBA, _definition: Drives. (line 17) * LBA, _definition: Drives. (line 17)
* libisofs, fixed "now" time: Loading. (line 217) * libisofs, fixed "now" time: Loading. (line 217)
@ -5884,39 +5900,39 @@ Node: Writing110455
Node: SetWrite120602 Node: SetWrite120602
Node: Bootable145360 Node: Bootable145360
Node: Jigdo172315 Node: Jigdo172315
Node: Charset176574 Node: Charset177318
Node: Exception179903 Node: Exception180647
Node: DialogCtl186032 Node: DialogCtl186776
Node: Inquiry188634 Node: Inquiry189378
Node: Navigate197516 Node: Navigate198260
Node: Verify205973 Node: Verify206717
Node: Restore216444 Node: Restore217188
Node: Emulation225121 Node: Emulation225865
Node: Scripting235577 Node: Scripting236321
Node: Frontend243360 Node: Frontend244104
Node: Examples252986 Node: Examples253730
Node: ExDevices254164 Node: ExDevices254908
Node: ExCreate254825 Node: ExCreate255569
Node: ExDialog256125 Node: ExDialog256869
Node: ExGrowing257396 Node: ExGrowing258140
Node: ExModifying258205 Node: ExModifying258949
Node: ExBootable258715 Node: ExBootable259459
Node: ExCharset259270 Node: ExCharset260014
Node: ExPseudo260166 Node: ExPseudo260910
Node: ExCdrecord261093 Node: ExCdrecord261837
Node: ExMkisofs261413 Node: ExMkisofs262157
Node: ExGrowisofs263310 Node: ExGrowisofs264054
Node: ExException264463 Node: ExException265207
Node: ExTime264921 Node: ExTime265665
Node: ExIncBackup265379 Node: ExIncBackup266123
Node: ExRestore269405 Node: ExRestore270149
Node: ExRecovery270351 Node: ExRecovery271095
Node: Files270923 Node: Files271667
Node: Environ272257 Node: Environ273001
Node: Seealso273005 Node: Seealso273749
Node: Bugreport273722 Node: Bugreport274466
Node: Legal274313 Node: Legal275057
Node: CommandIdx275325 Node: CommandIdx276069
Node: ConceptIdx292868 Node: ConceptIdx293612
 
End Tag Table End Tag Table

View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1) @c man .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISO 1 "Version 1.5.3, Oct 28, 2019" @c man .TH XORRISO 1 "Version 1.5.3, Nov 23, 2019"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@ -4351,14 +4351,19 @@ The .template file contains the compressed ISO image with reference tags
instead of the content bytes of the listed files. instead of the content bytes of the listed files.
@* @*
Input for this process are the normal arguments for a @command{xorriso} session Input for this process are the normal arguments for a @command{xorriso} session
on a blank -outdev, and a .md5 file which lists those data files which may be on a blank -outdev, and a checksum file which lists those data files which may
listed in the .jigdo file and externally referenced in the .template file. 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:
@* @*
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 symbolic file address
@* @*
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".
@*
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 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. 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 After To=From mapping, the file address gets written into the .jigdo
@ -4384,6 +4389,12 @@ emulation command.
Parameter @strong{clear} with any value empties the whole list. Parameter @strong{clear} with any value empties the whole list.
No .jigdo and .template file will be produced. No .jigdo and .template file will be produced.
@* @*
@strong{checksum_algorithm} 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".
@*
Alias: -jigdo-checksum-algorithm
@*
@strong{template_path} sets the disk_path for the .template file with the @strong{template_path} sets the disk_path for the .template file with the
holed and compressed ISO image copy. holed and compressed ISO image copy.
@* @*
@ -4394,7 +4405,12 @@ and download addresses for filling the holes in .template.
@* @*
Alias: -jigdo-jigdo Alias: -jigdo-jigdo
@* @*
@strong{md5_path} sets the disk_path where to find the .md5 input file. @strong{checksum_path} sets the disk_path where to find the checksum file with
symbolic file addresses and checksums according to @strong{checksum_algorithm}.
@*
Alias: md5_path
@*
Alias: -checksum-list
@* @*
Alias: -md5-list Alias: -md5-list
@* @*
@ -4409,15 +4425,19 @@ stay in .template in any case.
@* @*
Alias: -jigdo-exclude Alias: -jigdo-exclude
@* @*
@strong{demand_md5} adds a regular expression pattern which will get compared @strong{demand_checksum} adds a regular expression pattern which will get
with the absolute disk_path of any data file that was not found in the .md5 compared with the absolute disk_path of any data file that was not found
list. A match causes a MISHAP event. in the checksum list file as of "checksum_path". A match causes a MISHAP event.
@*
Alias: demand_md5
@*
Alias: -jigdo-force-checksum
@* @*
Alias: -jigdo-force-md5 Alias: -jigdo-force-md5
@* @*
@strong{mapping} adds a string pair of the form To=From to the parameter list. @strong{mapping} 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 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 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 replaced by the To string and a ':' character, before it goes into the .jigdo
file. The From string should end by a '/' character. file. The From string should end by a '/' character.

View File

@ -573,10 +573,11 @@ struct XorrisO { /* the global context of xorriso */
struct Xorriso_lsT *jigdo_params; struct Xorriso_lsT *jigdo_params;
struct Xorriso_lsT *jigdo_values; struct Xorriso_lsT *jigdo_values;
int libjte_params_given; /* bits: 0= outfile , 1= verbosity , 2= template_path int libjte_params_given; /* bits: 0= outfile , 1= verbosity , 2= template_path
3= jigdo_path , 4= md5_path , 5= min_size 3= jigdo_path , 4= checksum_path
6= checksum_iso , 7= checksum_template 5= min_size , 6= checksum_iso
8= compression , 9= exclude , 10= demand_md5 7= checksum_template , 8= compression
11= mapping 9= exclude , 10= demand_checksum
11= mapping , 12= checksum_algorithm
*/ */
/* LBA of boot image after image loading */ /* LBA of boot image after image loading */

View File

@ -1 +1 @@
#define Xorriso_timestamP "2019.11.23.132942" #define Xorriso_timestamP "2019.11.24.123339"

View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" 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. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" 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. instead of the content bytes of the listed files.
.br .br
Input for this process are the normal arguments for a \fBxorrisofs\fR Input for this process are the normal arguments for a \fBxorrisofs\fR
session session with no image loaded, and a checksum file which lists those
with no image loaded, and a .md5 file which lists those data files which may be data files which may be
listed in the .jigdo file and externally referenced in the .template file. 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 .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 symbolic file address
.br .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 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. 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 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. counted as part of the ISO image.
.br .br
.TP .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 \fB\-jigdo-jigdo\fR disk_path
Set the disk_path for the .jigdo file with the checksums Set the disk_path for the .jigdo file with the checksums
and download addresses for filling the holes in .template. 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 letter "k", "m", "g" to count KiB (1024 bytes), MiB (1024 KiB), or
GiB (1024 MiB). GiB (1024 MiB).
.TP .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 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 with the absolute disk_path of any data file that was not found in the
list. A match causes a MISHAP event, which normally does not abort 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. program run but finally causes a non\-zero exit value of the program.
.TP .TP
\fB\-jigdo-force-md5\fR disk_path_pattern
Outdated alias of \-jigdo\-force\-checksum.
.TP
\fB\-jigdo-exclude\fR disk_path_pattern \fB\-jigdo-exclude\fR disk_path_pattern
Add a regular expression pattern which will get compared Add a regular expression pattern which will get compared
with the absolute disk_path of any data file. A match causes the file to 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 \fB\-jigdo-map\fR To=From
Add a string pair of the form To=From to the parameter list. 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 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 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 replaced by the To string and a ':' character, before it goes into the .jigdo
file. The From string should end by a '/' character. file. The From string should end by a '/' character.
.TP .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 \fB\-md5-list\fR disk_path
Set the disk_path where to find the .md5 input file. Outdated alias of \-checksum\-list.
.TP .TP
\fB\-jigdo-template-compress\fR "gzip"|"bzip2" \fB\-jigdo-template-compress\fR "gzip"|"bzip2"
Choose one of "bzip2" or "gzip" for the compression of Choose one of "bzip2" or "gzip" for the compression of

View File

@ -1334,21 +1334,29 @@ One may determine the ability for Jigdo by:
.template file contains the compressed ISO image with reference tags .template file contains the compressed ISO image with reference tags
instead of the content bytes of the listed files. instead of the content bytes of the listed files.
Input for this process are the normal arguments for a 'xorrisofs' 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 files which may be listed in the .jigdo file and externally referenced
in the .template file. Each designated file is represented in the .md5 in the .template file. Each designated file is represented in the
file by a single text line: checksum file by a single text line:
MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 Checksum as hex digits, 2 blanks, size as 12 decimal digits or blanks, 2
blanks, symbolic file address blanks, symbolic file address
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
disk_path of the file which it shall match. The directory path of the values "md5" (32 hex digits) or "sha256" (64 hex digits). It will also
file address is decisive for To=From mapping, not for file recognition. be used for the file address lines in the .jigdo file. The default is
After To=From mapping, the file address gets written into the .jigdo "md5".
file. Jigdo restore tools will convert these addresses into really The file address in a checksum file line has to bear the same basename
reachable data source addresses from which they can read. 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 If the list of jigdo parameters is not empty, then padding will be
counted as part of the ISO image. 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 -jigdo-jigdo disk_path
Set the disk_path for the .jigdo file with the checksums and Set the disk_path for the .jigdo file with the checksums and
download addresses for filling the holes in .template. 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 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", number counting bytes, or a number with appended letter "k", "m",
"g" to count KiB (1024 bytes), MiB (1024 KiB), or GiB (1024 MiB). "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 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 absolute disk_path of any data file that was not found in the
list. A match causes a MISHAP event, which normally does not abort checksum file. A match causes a MISHAP event, which normally does
the program run but finally causes a non-zero exit value of the not abort the program run but finally causes a non-zero exit value
program. of the program.
-jigdo-force-md5 disk_path_pattern
Outdated alias of -jigdo-force-checksum.
-jigdo-exclude disk_path_pattern -jigdo-exclude disk_path_pattern
Add a regular expression pattern which will get compared with the Add a regular expression pattern which will get compared with the
absolute disk_path of any data file. A match causes the file to 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 -jigdo-map To=From
Add a string pair of the form To=From to the parameter list. If a 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 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 the file address from its line in the checksum file. This file
gets checked whether it begins with the From string. If so, then address gets checked whether it begins with the From string. If
this string will be replaced by the To string and a ':' character, so, then this string will be replaced by the To string and a ':'
before it goes into the .jigdo file. The From string should end by character, before it goes into the .jigdo file. The From string
a '/' character. 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 -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" -jigdo-template-compress "gzip"|"bzip2"
Choose one of "bzip2" or "gzip" for the compression of the template Choose one of "bzip2" or "gzip" for the compression of the template
file. The jigdo file is put out uncompressed. 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) * -C set load address and write address offset: Loading. (line 25)
* -cdrecord-params set load address and write address offset: Loading. * -cdrecord-params set load address and write address offset: Loading.
(line 41) (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. * -checksum_algorithm_template choose .template checksums: Jigdo.
(line 78) (line 92)
* -chrp-boot CHRP partition: SystemArea. (line 267) * -chrp-boot CHRP partition: SystemArea. (line 267)
* -chrp-boot-part CHRP partition: SystemArea. (line 258) * -chrp-boot-part CHRP partition: SystemArea. (line 258)
* -copyright set Copyright File path: ImageId. (line 66) * -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. * -iso_mbr_part_type Set type of ISO MBR partition: SystemArea.
(line 127) (line 127)
* -J enable production of Joliet directory tree: SetExtras. (line 147) * -J enable production of Joliet directory tree: SetExtras. (line 147)
* -jigdo-exclude add exclusion pattern for .md5: Jigdo. (line 55) * -jigdo-checksum-algorithm set data file checksum algorithm: Jigdo.
* -jigdo-force-md5 add check pattern for .md5: Jigdo. (line 49) (line 42)
* -jigdo-jigdo set name of .jigdo file: Jigdo. (line 38) * -jigdo-exclude add exclusion pattern for checksum file: Jigdo.
* -jigdo-map add address translation for .jigdo: Jigdo. (line 59) (line 65)
* -jigdo-min-file-size set minimum extract size: Jigdo. (line 44) * -jigdo-force-checksum add check pattern for checksum file: Jigdo.
* -jigdo-template set name of .template file: Jigdo. (line 41) (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. * -jigdo-template-compress choose compression algorithm: Jigdo.
(line 69) (line 83)
* -joliet enable production of Joliet directory tree: SetExtras. * -joliet enable production of Joliet directory tree: SetExtras.
(line 151) (line 151)
* -joliet-long allow longer Joliet names: SetExtras. (line 153) * -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) * -M set path for loading existing ISO image: Loading. (line 11)
* -max-iso9660-filenames allow 37 characters in ISO file names: SetCompl. * -max-iso9660-filenames allow 37 characters in ISO file names: SetCompl.
(line 61) (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) * -mips-boot MIPS Big Endian boot image: SystemArea. (line 274)
* -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 280) * -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 280)
* -N omit version number in ISO file names: SetCompl. (line 64) * -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 level, specify, -iso-level <1>: SetCompl. (line 8)
* ISO root directory, redirect, -root: SetInsert. (line 55) * ISO root directory, redirect, -root: SetInsert. (line 55)
* iso_rr_path, _definition: Insert. (line 8) * 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. * Jigdo Template Extraction, -checksum_algorithm_template: Jigdo.
(line 78) (line 92)
* Jigdo Template Extraction, -jigdo-exclude: Jigdo. (line 55) * Jigdo Template Extraction, -jigdo-checksum-algorithm: Jigdo.
* Jigdo Template Extraction, -jigdo-force-md5: Jigdo. (line 49) (line 42)
* Jigdo Template Extraction, -jigdo-jigdo: Jigdo. (line 38) * Jigdo Template Extraction, -jigdo-exclude: Jigdo. (line 65)
* Jigdo Template Extraction, -jigdo-map: Jigdo. (line 59) * Jigdo Template Extraction, -jigdo-force-checksum: Jigdo. (line 57)
* Jigdo Template Extraction, -jigdo-min-file-size: Jigdo. (line 44) * Jigdo Template Extraction, -jigdo-force-md5: Jigdo. (line 63)
* Jigdo Template Extraction, -jigdo-template: Jigdo. (line 41) * Jigdo Template Extraction, -jigdo-jigdo: Jigdo. (line 46)
* Jigdo Template Extraction, -jigdo-template-compress: Jigdo. (line 69) * Jigdo Template Extraction, -jigdo-map: Jigdo. (line 69)
* Jigdo Template Extraction, -md5-list: Jigdo. (line 67) * 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) * Jigdo Template Extraction, _definition: Jigdo. (line 6)
* Joliet, allows longer names, -joliet-long: SetExtras. (line 153) * Joliet, allows longer names, -joliet-long: SetExtras. (line 153)
* Joliet, enable, -J, -joliet: SetExtras. (line 147) * Joliet, enable, -J, -joliet: SetExtras. (line 147)
@ -2418,21 +2443,21 @@ Node: Bootable38983
Node: SystemArea45269 Node: SystemArea45269
Node: Charset63501 Node: Charset63501
Node: Jigdo64526 Node: Jigdo64526
Node: Miscellaneous68803 Node: Miscellaneous69496
Node: Examples70448 Node: Examples71141
Node: ExSimple70942 Node: ExSimple71635
Node: ExGraft71425 Node: ExGraft72118
Node: ExMkisofs72725 Node: ExMkisofs73418
Node: ExGrowisofs74533 Node: ExGrowisofs75226
Node: ExIncBackup75723 Node: ExIncBackup76416
Node: ExIncBckAcc78899 Node: ExIncBckAcc79592
Node: ExBootable80604 Node: ExBootable81297
Node: Files84786 Node: Files85479
Node: Environ85881 Node: Environ86574
Node: Seealso86754 Node: Seealso87447
Node: Bugreport87405 Node: Bugreport88098
Node: Legal87998 Node: Legal88691
Node: CommandIdx88895 Node: CommandIdx89588
Node: ConceptIdx104763 Node: ConceptIdx105940
 
End Tag Table End Tag Table

View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1) @c man .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISOFS 1 "Version 1.5.3, Oct 28, 2019" @c man .TH XORRISOFS 1 "Version 1.5.3, Nov 23, 2019"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@ -2004,15 +2004,20 @@ The .template file contains the compressed ISO image with reference tags
instead of the content bytes of the listed files. instead of the content bytes of the listed files.
@* @*
Input for this process are the normal arguments for a @command{xorrisofs} Input for this process are the normal arguments for a @command{xorrisofs}
session session with no image loaded, and a checksum file which lists those
with no image loaded, and a .md5 file which lists those data files which may be data files which may be
listed in the .jigdo file and externally referenced in the .template file. 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:
@* @*
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 symbolic file address
@* @*
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".
@*
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 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. 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 After To=From mapping, the file address gets written into the .jigdo
@ -2025,6 +2030,12 @@ counted as part of the ISO image.
@table @asis @table @asis
@sp 1 @sp 1
@c man .TP @c man .TP
@item -jigdo-checksum-algorithm "md5"|"sha256"
@kindex -jigdo-checksum-algorithm set data file checksum algorithm
@cindex Jigdo Template Extraction, -jigdo-checksum-algorithm
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".
@c man .TP
@item -jigdo-jigdo disk_path @item -jigdo-jigdo disk_path
@kindex -jigdo-jigdo set name of .jigdo file @kindex -jigdo-jigdo set name of .jigdo file
@cindex Jigdo Template Extraction, -jigdo-jigdo @cindex Jigdo Template Extraction, -jigdo-jigdo
@ -2046,16 +2057,22 @@ 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 letter "k", "m", "g" to count KiB (1024 bytes), MiB (1024 KiB), or
GiB (1024 MiB). GiB (1024 MiB).
@c man .TP @c man .TP
@item -jigdo-force-md5 disk_path_pattern @item -jigdo-force-checksum disk_path_pattern
@kindex -jigdo-force-md5 add check pattern for .md5 @kindex -jigdo-force-checksum add check pattern for checksum file
@cindex Jigdo Template Extraction, -jigdo-force-md5 @cindex Jigdo Template Extraction, -jigdo-force-checksum
adds a regular expression pattern which will get compared 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 with the absolute disk_path of any data file that was not found in the
list. A match causes a MISHAP event, which normally does not abort 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. program run but finally causes a non-zero exit value of the program.
@c man .TP @c man .TP
@item -jigdo-force-md5 disk_path_pattern
@kindex -jigdo-force-md5 add check pattern for checksum file
@cindex Jigdo Template Extraction, -jigdo-force-md5
Outdated alias of -jigdo-force-checksum.
@c man .TP
@item -jigdo-exclude disk_path_pattern @item -jigdo-exclude disk_path_pattern
@kindex -jigdo-exclude add exclusion pattern for .md5 @kindex -jigdo-exclude add exclusion pattern for checksum file
@cindex Jigdo Template Extraction, -jigdo-exclude @cindex Jigdo Template Extraction, -jigdo-exclude
Add a regular expression pattern which will get compared Add a regular expression pattern which will get compared
with the absolute disk_path of any data file. A match causes the file to with the absolute disk_path of any data file. A match causes the file to
@ -2066,15 +2083,21 @@ stay in .template in any case.
@cindex Jigdo Template Extraction, -jigdo-map @cindex Jigdo Template Extraction, -jigdo-map
Add a string pair of the form To=From to the parameter list. 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 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 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 replaced by the To string and a ':' character, before it goes into the .jigdo
file. The From string should end by a '/' character. file. The From string should end by a '/' character.
@c man .TP @c man .TP
@item -checksum-list disk_path
@kindex -checksum-list set path of input checksum file
@cindex Jigdo Template Extraction, -checksum-list
Set the disk_path where to find the checksum file file with
symbolic file addresses and checksums according to -jigdo-checksum-algorithm.
@c man .TP
@item -md5-list disk_path @item -md5-list disk_path
@kindex -md5-list set path of readable .md5 @kindex -md5-list set path of input checksum file
@cindex Jigdo Template Extraction, -md5-list @cindex Jigdo Template Extraction, -md5-list
Set the disk_path where to find the .md5 input file. Outdated alias of -checksum-list.
@c man .TP @c man .TP
@item -jigdo-template-compress "gzip"|"bzip2" @item -jigdo-template-compress "gzip"|"bzip2"
@kindex -jigdo-template-compress choose compression algorithm @kindex -jigdo-template-compress choose compression algorithm