New -error_behavior behavior occasion "file_extraction"

xorriso/xorriso.1

@@ -2,7 +2,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 "Aug 22, 2008"
+.TH XORRISO 1 "Aug 24, 2008"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -57,6 +57,8 @@ Can perform multi-session tasks as emulation of mkisofs and cdrecord.
 .br
 Can restore files from ISO image to disk filesystem (see osirrox).
 .br
+Can check media for damages and copy readable blocks to disk.
+.br
 Scans for optical drives, blanks re-useable optical media.
 .br
 Reads its instructions from command line arguments, dialog, and batch files.
@@ -1428,10 +1430,11 @@ of xorriso begin. Only "-report_about" with dash "-" is recognized that way.
 .TP
 \fB\-error_behavior\fR occasion behavior
 Control the program behavior at problem event occasions.
+For now this applies to occasions "image_loading" which is given while
+an image tree is read from the input device, and to "file_extraction" which
+is given with osirrox options like -extract.
 .br
-For now this applies only to occasion "image_loading" which is given while
-an image tree is read from the input device. There are three behaviors
-available:
+With "image_loading" there are three behaviors available:
 .br
 "best_effort" goes on with reading after events with severity below FAILURE
 if the threshold of option -abort_on allows this.
@@ -1441,6 +1444,11 @@ It issues an own FAILURE event.
 .br
 "fatal" acts like "failure" but issues the own event as FATAL.
 This is the default.
+.br
+With occasion "file_extraction" there are two behaviors:
+.br
+"keep" maintains incompletely extracted files on disk. "delete" removes
+files which encountered errors during content extraction.
 .TP
 .B Dialog mode control:
 .TP
@@ -2458,7 +2466,21 @@ Avoid to eventually create /home/thomas/restored without rwx-permission.
  -extract /personal_mail /home/thomas/restored/personal_mail
 .br
  -rollback_end
+.SS
+.B Try to retrieve as many blocks as possible from a damaged media
 .br
+\fB$\fR xorriso -abort_on NEVER -indev /dev/sr0 \\
+.br
+ -check_media time_limit=1800 report=blocks_files \\
+.br
+ data_to="$HOME"/dvd_copy sector_map="$HOME"/dvd_copy.map --
+.br
+This can be repeated several times, eventually with -eject or with other
+-indev drives. See the human readable part of "$HOME"/dvd_copy.map for
+addresses which can be used on "$HOME"/dvd_copy with mount option sbsector=.
+.br
+If you want to make the newest session the default mount session, you
+may add option "patch_lba0=on" to the final -check_media run.
 .SH FILES
 .SS 
 .B Startup files: