Enhanced xorriso docs about meaning of .md5 file addresses

This commit is contained in:
Thomas Schmitt 2010-10-07 17:53:54 +00:00
parent 5a701af9d0
commit 921bdc75cd
3 changed files with 69 additions and 64 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 "Oct 03, 2010"
.TH XORRISO 1 "Oct 07, 2010"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -2420,21 +2420,24 @@ end users to download them more efficiently."
.br
xorriso can produce a .jigdo and a .template file together with a
single-session ISO image.
The .jigdo file contains checksums and file download addresses.
The .jigdo file contains checksums and symbolic file addresses.
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 xorriso session
on a blank -outdev, and a .md5 file which lists those files which shall be
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 desired file is represented in the .md5 file by a single text line:
Each designated file is represented in the .md5 file by a single text line:
.br
MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 blanks,
file address
symbolic file address
.br
The file address in an .md5 line has to bear the same basename as the
absolute 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.
After eventual 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.
.br
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, and
@ -2477,8 +2480,7 @@ 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 currently causes sudden program abort.
(Should become a MISHAP event.)
list. A match causes a MISHAP event.
.br
Alias: -jigdo-force-md5
.br

View File

@ -2156,21 +2156,23 @@ large files like CD and DVD images; see http://atterer.net/jigdo/ for
more details. Debian CDs and DVD ISO images are published on the web in
jigdo format to allow end users to download them more efficiently."
xorriso can produce a .jigdo and a .template file together with a
single-session ISO image. The .jigdo file contains checksums and file
download addresses. The .template file contains the compressed ISO
image with reference tags instead of the content bytes of the listed
files.
single-session ISO image. The .jigdo file contains checksums and
symbolic file addresses. The .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 xorriso session
on a blank -outdev, and a .md5 file which lists those files which shall
be listed in the .jigdo file and externally referenced in the .template
file. Each desired file is represented in the .md5 file by a single
text line:
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:
MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2
blanks, file address
blanks, symbolic file address
The file address in an .md5 line has to bear the same basename as the
absolute 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.
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 eventual 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
to write to non-blank targets, it will disable multi-session emulation,
and eventual padding will be counted as part of the ISO image.
@ -2200,8 +2202,7 @@ and eventual padding will be counted as part of the ISO image.
Alias: -jigdo-exclude
*demand_md5* 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 currently causes sudden program
abort. (Should become a MISHAP event.)
found in the .md5 list. A match causes a MISHAP event.
Alias: -jigdo-force-md5
*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
@ -3921,7 +3922,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -indev aquires a drive for input: AqDrive. (line 22)
* -iso_rr_pattern controls pattern expansion: Manip. (line 10)
* -jigdo clears JTE or sets input/output character set: Jigdo.
(line 31)
(line 33)
* -joliet enables production of Joliet tree: SetWrite. (line 10)
* -list_delimiter replaces '--': Scripting. (line 38)
* -list_formats lists available formats: Writing. (line 107)
@ -4139,7 +4140,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Insert, pathspecs, -add: Insert. (line 42)
* Insert, piece of data file, -cut_out: Insert. (line 126)
* iso_rr_path, _definition: Insert. (line 7)
* Jigdo Template Extraction, -jigdo: Jigdo. (line 31)
* Jigdo Template Extraction, -jigdo: Jigdo. (line 33)
* Jigdo Template Extraction, _definition: Jigdo. (line 6)
* List delimiter, _definiton: Processing. (line 8)
* MBR, _definiton: Extras. (line 26)
@ -4287,37 +4288,37 @@ Node: Writing79789
Node: SetWrite86078
Node: Bootable98029
Node: Jigdo107119
Node: Charset111222
Node: Exception113973
Node: DialogCtl118488
Node: Inquiry120833
Node: Navigate124963
Node: Verify132561
Node: Restore140981
Node: Emulation147637
Node: Scripting155637
Node: Frontend161199
Node: Examples162400
Node: ExDevices163569
Node: ExCreate164203
Node: ExDialog165477
Node: ExGrowing166739
Node: ExModifying167541
Node: ExBootable168042
Node: ExCharset168589
Node: ExPseudo169417
Node: ExCdrecord170311
Node: ExMkisofs170626
Node: ExGrowisofs171629
Node: ExException172753
Node: ExTime173207
Node: ExIncBackup173666
Node: ExRestore177138
Node: ExRecovery178107
Node: Files178673
Node: Seealso179901
Node: Legal180425
Node: CommandIdx181347
Node: ConceptIdx195291
Node: Charset111377
Node: Exception114128
Node: DialogCtl118643
Node: Inquiry120988
Node: Navigate125118
Node: Verify132716
Node: Restore141136
Node: Emulation147792
Node: Scripting155792
Node: Frontend161354
Node: Examples162555
Node: ExDevices163724
Node: ExCreate164358
Node: ExDialog165632
Node: ExGrowing166894
Node: ExModifying167696
Node: ExBootable168197
Node: ExCharset168744
Node: ExPseudo169572
Node: ExCdrecord170466
Node: ExMkisofs170781
Node: ExGrowisofs171784
Node: ExException172908
Node: ExTime173362
Node: ExIncBackup173821
Node: ExRestore177293
Node: ExRecovery178262
Node: Files178828
Node: Seealso180056
Node: Legal180580
Node: CommandIdx181502
Node: ConceptIdx195446

End Tag Table

View File

@ -44,7 +44,7 @@
@c man .\" First parameter, NAME, should be all caps
@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 .TH XORRISO 1 "Oct 03, 2010"
@c man .TH XORRISO 1 "Oct 07, 2010"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@ -2894,21 +2894,24 @@ end users to download them more efficiently."
@*
xorriso can produce a .jigdo and a .template file together with a
single-session ISO image.
The .jigdo file contains checksums and file download addresses.
The .jigdo file contains checksums and symbolic file addresses.
The .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 xorriso session
on a blank -outdev, and a .md5 file which lists those files which shall be
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 desired file is represented in the .md5 file by a single text line:
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 blanks,
file address
symbolic file address
@*
The file address in an .md5 line has to bear the same basename as the
absolute 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.
After eventual 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 to
write to non-blank targets, it will disable multi-session emulation, and
@ -2955,8 +2958,7 @@ Alias: -jigdo-exclude
@*
@strong{demand_md5} 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 currently causes sudden program abort.
(Should become a MISHAP event.)
list. A match causes a MISHAP event.
@*
Alias: -jigdo-force-md5
@*