libburnia/legacy
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 5a701af9d0
commit 921bdc75cd
3 changed files with 69 additions and 64 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
libisoburn/trunk/xorriso/xorriso.1
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