libburnia/libisoburn
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Enhanced xorriso docs about meaning of .md5 file addresses

Browse Source
This commit is contained in:
Thomas Schmitt 2010-10-07 17:53:54 +00:00
parent 55c8f1d964
commit 399cbf6d66
3 changed files with 69 additions and 64 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
xorriso/xorriso.1
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 "Oct 03, 2010" .TH XORRISO 1 "Oct 07, 2010"
.\" 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:
@ -2420,21 +2420,24 @@ end users to download them more efficiently."
.br .br
xorriso can produce a .jigdo and a .template file together with a xorriso can produce a .jigdo and a .template file together with a
single-session ISO image. 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 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 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 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. 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 .br
MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 blanks, MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 blanks,
file address symbolic file address
.br .br
The file address in an .md5 line has to bear the same basename as the 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. 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 .br
If the list of jigdo parameters is not empty, then xorriso will refuse to 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 write to non-blank targets, it will disable multi-session emulation, and
@ -2477,8 +2480,7 @@ Alias: -jigdo-exclude
.br .br
\fBdemand_md5\fR adds a regular expression pattern which will get compared \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 with the absolute disk_path of any data file that was not found in the .md5
list. A match currently causes sudden program abort. list. A match causes a MISHAP event.
(Should become a MISHAP event.)
.br .br
Alias: -jigdo-force-md5 Alias: -jigdo-force-md5
.br .br

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

18
xorriso/xorriso.texi
View File

@ -44,7 +44,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 "Oct 03, 2010" @c man .TH XORRISO 1 "Oct 07, 2010"
@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:
@ -2894,21 +2894,24 @@ end users to download them more efficiently."
@* @*
xorriso can produce a .jigdo and a .template file together with a xorriso can produce a .jigdo and a .template file together with a
single-session ISO image. 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 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 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 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. 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, 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 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. 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 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 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 @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 with the absolute disk_path of any data file that was not found in the .md5
list. A match currently causes sudden program abort. list. A match causes a MISHAP event.
(Should become a MISHAP event.)
@* @*
Alias: -jigdo-force-md5 Alias: -jigdo-force-md5
@* @*