Clarification about -md5, -check_media and -find ... -damaged
This commit is contained in:
parent
4cdd884731
commit
5427d7a8f2
@ -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 "Dec 06, 2010"
|
.TH XORRISO 1 "Dec 10, 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:
|
||||||
@ -376,9 +376,8 @@ demands a file name length of up to 255 characters and paths of up to 1024
|
|||||||
characters. Rock Ridge fulfills this demand.
|
characters. Rock Ridge fulfills this demand.
|
||||||
.PP
|
.PP
|
||||||
An \fBEl Torito\fR
|
An \fBEl Torito\fR
|
||||||
boot record connects one or more boot images, which are binary program files
|
boot record points the BIOS bootstrapping facility to one or more boot
|
||||||
stored in the ISO image, with the bootstrapping facility of
|
images, which are binary program files stored in the ISO image.
|
||||||
contemporary computers.
|
|
||||||
The content of the boot image files is not in the scope of El Torito.
|
The content of the boot image files is not in the scope of El Torito.
|
||||||
.br
|
.br
|
||||||
Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images.
|
Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images.
|
||||||
@ -397,7 +396,8 @@ Emulation -as mkisofs supports the example options out of the ISOLINUX wiki,
|
|||||||
the options used in GRUB script grub-mkrescue, and the example in the
|
the options used in GRUB script grub-mkrescue, and the example in the
|
||||||
FreeBSD AvgLiveCD wiki.
|
FreeBSD AvgLiveCD wiki.
|
||||||
.br
|
.br
|
||||||
The support for other boot image types is sparse.
|
There is support for boot facilities other than PC BIOS:
|
||||||
|
EFI, MIPS Big Endian (SGI), MIPS Little Endian (DEC), SUN SPARC.
|
||||||
.br
|
.br
|
||||||
.PP
|
.PP
|
||||||
\fBACL\fR
|
\fBACL\fR
|
||||||
@ -1505,6 +1505,9 @@ Matches files which use data blocks marked as damaged by a previous
|
|||||||
run of -check_media. The damage info vanishes when a new ISO image gets
|
run of -check_media. The damage info vanishes when a new ISO image gets
|
||||||
loaded.
|
loaded.
|
||||||
.br
|
.br
|
||||||
|
Note that a MD5 session mismatch marks all files of the session as damaged.
|
||||||
|
If finer distinction is desired, perform -md5 off before -check_media.
|
||||||
|
.br
|
||||||
\fB\-pending_data\fR :
|
\fB\-pending_data\fR :
|
||||||
Matches files which get their content from outside the loaded ISO image.
|
Matches files which get their content from outside the loaded ISO image.
|
||||||
.br
|
.br
|
||||||
@ -1718,7 +1721,7 @@ E.g.:
|
|||||||
.br
|
.br
|
||||||
\fBestimate_size\fR
|
\fBestimate_size\fR
|
||||||
prints a lower and an upper estimation of the number of blocks which the
|
prints a lower and an upper estimation of the number of blocks which the
|
||||||
found files together will occupy in the emering ISO image.
|
found files together will occupy in the emerging ISO image.
|
||||||
This does not account for the superblock,
|
This does not account for the superblock,
|
||||||
for the directories in the -find path, or for image padding.
|
for the directories in the -find path, or for image padding.
|
||||||
.br
|
.br
|
||||||
@ -3042,7 +3045,7 @@ given as start address for -findx.
|
|||||||
actions it will always perform action "echo".
|
actions it will always perform action "echo".
|
||||||
.br
|
.br
|
||||||
\fBin_iso\fR
|
\fBin_iso\fR
|
||||||
reports the path if its counterpart exist in the ISO image.
|
reports the path if its counterpart exists in the ISO image.
|
||||||
For this the disk_path of the -findx command gets replaced
|
For this the disk_path of the -findx command gets replaced
|
||||||
by the iso_rr_path given as parameter.
|
by the iso_rr_path given as parameter.
|
||||||
.br
|
.br
|
||||||
@ -3066,6 +3069,12 @@ contains files. To be used with -type "m" to report mount points.
|
|||||||
\fBempty_iso_dir\fR
|
\fBempty_iso_dir\fR
|
||||||
deletes all files from the counterpart
|
deletes all files from the counterpart
|
||||||
in the ISO image. To be used with -type "m" to truncate mount points.
|
in the ISO image. To be used with -type "m" to truncate mount points.
|
||||||
|
.br
|
||||||
|
\fBestimate_size\fR
|
||||||
|
prints a lower and an upper estimation of the number of blocks which the
|
||||||
|
found files together will occupy in the emerging ISO image.
|
||||||
|
This does not account for the superblock,
|
||||||
|
for the directories in the -findx path, or for image padding.
|
||||||
.TP
|
.TP
|
||||||
\fB\-compare\fR disk_path iso_rr_path
|
\fB\-compare\fR disk_path iso_rr_path
|
||||||
Compare attributes and eventual data file content of a fileobject in the
|
Compare attributes and eventual data file content of a fileobject in the
|
||||||
@ -3177,6 +3186,8 @@ Non-default options are:
|
|||||||
\fBreport="files"\fR
|
\fBreport="files"\fR
|
||||||
lists the files which use damaged blocks (not with use=outdev).
|
lists the files which use damaged blocks (not with use=outdev).
|
||||||
The format is like with find -exec report_damage.
|
The format is like with find -exec report_damage.
|
||||||
|
Note that a MD5 session mismatch marks all files of the session as damaged.
|
||||||
|
If finer distinction is desired, perform -md5 off before -check_media.
|
||||||
.br
|
.br
|
||||||
\fBreport="blocks_files"\fR
|
\fBreport="blocks_files"\fR
|
||||||
first lists damaged blocks and then affected files.
|
first lists damaged blocks and then affected files.
|
||||||
|
@ -335,10 +335,10 @@ characters of filename length. It is the X/Open System Interface
|
|||||||
standard XSI which demands a file name length of up to 255 characters
|
standard XSI which demands a file name length of up to 255 characters
|
||||||
and paths of up to 1024 characters. Rock Ridge fulfills this demand.
|
and paths of up to 1024 characters. Rock Ridge fulfills this demand.
|
||||||
|
|
||||||
An *El Torito* boot record connects one or more boot images, which
|
An *El Torito* boot record points the BIOS bootstrapping facility to
|
||||||
are binary program files stored in the ISO image, with the
|
one or more boot images, which are binary program files stored in the
|
||||||
bootstrapping facility of contemporary computers. The content of the
|
ISO image. The content of the boot image files is not in the scope of
|
||||||
boot image files is not in the scope of El Torito.
|
El Torito.
|
||||||
Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot
|
Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot
|
||||||
images. xorriso is able to create or maintain an El Torito object
|
images. xorriso is able to create or maintain an El Torito object
|
||||||
which makes such an image bootable. For details see option -boot_image.
|
which makes such an image bootable. For details see option -boot_image.
|
||||||
@ -351,7 +351,8 @@ follow-up session can get in effect only on overwriteable media.
|
|||||||
Emulation -as mkisofs supports the example options out of the ISOLINUX
|
Emulation -as mkisofs supports the example options out of the ISOLINUX
|
||||||
wiki, the options used in GRUB script grub-mkrescue, and the example in
|
wiki, the options used in GRUB script grub-mkrescue, and the example in
|
||||||
the FreeBSD AvgLiveCD wiki.
|
the FreeBSD AvgLiveCD wiki.
|
||||||
The support for other boot image types is sparse.
|
There is support for boot facilities other than PC BIOS: EFI, MIPS Big
|
||||||
|
Endian (SGI), MIPS Little Endian (DEC), SUN SPARC.
|
||||||
|
|
||||||
*ACL* are an advanced way of controlling access permissions to file
|
*ACL* are an advanced way of controlling access permissions to file
|
||||||
objects. Neither ISO 9660 nor Rock Ridge specify a way to record ACLs.
|
objects. Neither ISO 9660 nor Rock Ridge specify a way to record ACLs.
|
||||||
@ -1377,6 +1378,9 @@ File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Options
|
|||||||
Matches files which use data blocks marked as damaged by a
|
Matches files which use data blocks marked as damaged by a
|
||||||
previous run of -check_media. The damage info vanishes when a
|
previous run of -check_media. The damage info vanishes when a
|
||||||
new ISO image gets loaded.
|
new ISO image gets loaded.
|
||||||
|
Note that a MD5 session mismatch marks all files of the
|
||||||
|
session as damaged. If finer distinction is desired, perform
|
||||||
|
-md5 off before -check_media.
|
||||||
-pending_data :
|
-pending_data :
|
||||||
Matches files which get their content from outside the loaded
|
Matches files which get their content from outside the loaded
|
||||||
ISO image.
|
ISO image.
|
||||||
@ -1546,7 +1550,7 @@ File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Options
|
|||||||
estimate_size
|
estimate_size
|
||||||
prints a lower and an upper estimation of the number of
|
prints a lower and an upper estimation of the number of
|
||||||
blocks which the found files together will occupy in the
|
blocks which the found files together will occupy in the
|
||||||
emering ISO image. This does not account for the superblock,
|
emerging ISO image. This does not account for the superblock,
|
||||||
for the directories in the -find path, or for image padding.
|
for the directories in the -find path, or for image padding.
|
||||||
find
|
find
|
||||||
performs another run of -find on the matching file address.
|
performs another run of -find on the matching file address.
|
||||||
@ -2695,7 +2699,7 @@ File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Options
|
|||||||
following few actions it will always perform action "echo".
|
following few actions it will always perform action "echo".
|
||||||
|
|
||||||
in_iso
|
in_iso
|
||||||
reports the path if its counterpart exist in the ISO image.
|
reports the path if its counterpart exists in the ISO image.
|
||||||
For this the disk_path of the -findx command gets replaced by
|
For this the disk_path of the -findx command gets replaced by
|
||||||
the iso_rr_path given as parameter.
|
the iso_rr_path given as parameter.
|
||||||
E.g.: -findx /home/thomas -exec in_iso /thomas_on_cd --
|
E.g.: -findx /home/thomas -exec in_iso /thomas_on_cd --
|
||||||
@ -2712,6 +2716,11 @@ File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Options
|
|||||||
empty_iso_dir
|
empty_iso_dir
|
||||||
deletes all files from the counterpart in the ISO image. To
|
deletes all files from the counterpart in the ISO image. To
|
||||||
be used with -type "m" to truncate mount points.
|
be used with -type "m" to truncate mount points.
|
||||||
|
estimate_size
|
||||||
|
prints a lower and an upper estimation of the number of
|
||||||
|
blocks which the found files together will occupy in the
|
||||||
|
emerging ISO image. This does not account for the superblock,
|
||||||
|
for the directories in the -findx path, or for image padding.
|
||||||
|
|
||||||
-compare disk_path iso_rr_path
|
-compare disk_path iso_rr_path
|
||||||
Compare attributes and eventual data file content of a fileobject
|
Compare attributes and eventual data file content of a fileobject
|
||||||
@ -2812,7 +2821,9 @@ transmission errors.
|
|||||||
report="files"
|
report="files"
|
||||||
lists the files which use damaged blocks (not with
|
lists the files which use damaged blocks (not with
|
||||||
use=outdev). The format is like with find -exec
|
use=outdev). The format is like with find -exec
|
||||||
report_damage.
|
report_damage. Note that a MD5 session mismatch marks all
|
||||||
|
files of the session as damaged. If finer distinction is
|
||||||
|
desired, perform -md5 off before -check_media.
|
||||||
report="blocks_files"
|
report="blocks_files"
|
||||||
first lists damaged blocks and then affected files.
|
first lists damaged blocks and then affected files.
|
||||||
use="outdev"
|
use="outdev"
|
||||||
@ -3945,8 +3956,8 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* -cd sets working directory in ISO: Navigate. (line 7)
|
* -cd sets working directory in ISO: Navigate. (line 7)
|
||||||
* -cdx sets working directory on disk: Navigate. (line 16)
|
* -cdx sets working directory on disk: Navigate. (line 16)
|
||||||
* -charset sets input/output character set: Charset. (line 43)
|
* -charset sets input/output character set: Charset. (line 43)
|
||||||
* -check_md5 verifies file checksum: Verify. (line 144)
|
* -check_md5 verifies file checksum: Verify. (line 146)
|
||||||
* -check_md5_r verifies file tree checksums: Verify. (line 160)
|
* -check_md5_r verifies file tree checksums: Verify. (line 162)
|
||||||
* -check_media reads media block by block: Verify. (line 21)
|
* -check_media reads media block by block: Verify. (line 21)
|
||||||
* -check_media_defaults sets -check_media options: Verify. (line 40)
|
* -check_media_defaults sets -check_media options: Verify. (line 40)
|
||||||
* -chgrp sets group in ISO image: Manip. (line 50)
|
* -chgrp sets group in ISO image: Manip. (line 50)
|
||||||
@ -3959,9 +3970,9 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* -close_filter_list bans filter registration: Filter. (line 52)
|
* -close_filter_list bans filter registration: Filter. (line 52)
|
||||||
* -commit writes pending ISO image: Writing. (line 13)
|
* -commit writes pending ISO image: Writing. (line 13)
|
||||||
* -commit_eject writes and ejects: Writing. (line 40)
|
* -commit_eject writes and ejects: Writing. (line 40)
|
||||||
* -compare reports ISO/disk differences: Navigate. (line 134)
|
* -compare reports ISO/disk differences: Navigate. (line 139)
|
||||||
* -compare_l reports ISO/disk differences: Navigate. (line 152)
|
* -compare_l reports ISO/disk differences: Navigate. (line 157)
|
||||||
* -compare_r reports ISO/disk differences: Navigate. (line 147)
|
* -compare_r reports ISO/disk differences: Navigate. (line 152)
|
||||||
* -compliance controls standard compliance: SetWrite. (line 14)
|
* -compliance controls standard compliance: SetWrite. (line 14)
|
||||||
* -copyright_file sets copyright file name: SetWrite. (line 125)
|
* -copyright_file sets copyright file name: SetWrite. (line 125)
|
||||||
* -cp_rx copies file trees to disk: Restore. (line 104)
|
* -cp_rx copies file trees to disk: Restore. (line 104)
|
||||||
@ -4092,8 +4103,8 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* -setfattr sets xattr in ISO image: Manip. (line 110)
|
* -setfattr sets xattr in ISO image: Manip. (line 110)
|
||||||
* -setfattr_list sets xattr in ISO image: Manip. (line 126)
|
* -setfattr_list sets xattr in ISO image: Manip. (line 126)
|
||||||
* -setfattr_r sets xattr in ISO image: Manip. (line 123)
|
* -setfattr_r sets xattr in ISO image: Manip. (line 123)
|
||||||
* -show_stream shows data source and filters: Navigate. (line 157)
|
* -show_stream shows data source and filters: Navigate. (line 162)
|
||||||
* -show_stream_r shows data source and filters: Navigate. (line 172)
|
* -show_stream_r shows data source and filters: Navigate. (line 177)
|
||||||
* -speed set write speed: SetWrite. (line 182)
|
* -speed set write speed: SetWrite. (line 182)
|
||||||
* -split_size enables large file splitting: SetInsert. (line 140)
|
* -split_size enables large file splitting: SetInsert. (line 140)
|
||||||
* -status shows current settings: Scripting. (line 25)
|
* -status shows current settings: Scripting. (line 25)
|
||||||
@ -4125,7 +4136,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
|||||||
|