Imported Upstream version 0.79.2

documentation/dvdisaster.en.1

@@ -1,11 +1,11 @@
-.TH DVDISASTER 1 "2009-07-04" "0.72" "protection for CD/DVD media"
+.TH DVDISASTER 1 "2010-02-06" "0.80" "protection for CD/DVD media"
 
 .SH NAME
 DVDISASTER \- data loss/scratch/aging protection for CD/DVD media
 
 .SH SYNOPSIS
 .B dvdisaster
-.RB [\| \-r \||\| \-c \||\| \-f \||\| \-s \||\| \-t \||\| \-u \|]
+.RB [\| \-r \||\| \-c \||\| \-f \||\| \-s \||\| \-t[q] \||\| \-u \|]
 .RB [\| \-d
 .IR device \|]
 .RB [\| \-p
@@ -14,7 +14,10 @@ DVDISASTER \- data loss/scratch/aging protection for CD/DVD media
 .IR image \|]
 .RB [\| \-e
 .IR eccfile \|]
-.RB [\| \-\-list \|]
+.RB [\| \-o
+.IR file|image \|]
+.RB [\| \-a
+.IR codec-list \|]
 .RB [\| \-j
 .IR n \|]
 .RB [\| -n
@@ -22,18 +25,25 @@ DVDISASTER \- data loss/scratch/aging protection for CD/DVD media
 .RB [\| -m
 .IR n \|]
 .RB [\| -v \|]
+.RB [\| -x
+.IR n \|]
 .RB [\| \-\-adaptive-read \|]
 .RB [\| \-\-auto-suffix \|]
 .RB [\| \-\-cache-size
 .IR n \|]
 .RB [\| \-\-dao \|]
+.RB [\| \-\-defective-dump
+.IR d \|]
+.RB [\| \-\-driver
+.IR d \|]
 .RB [\| \-\-eject \|]
 .RB [\| \-\-fill-unreadable
 .IR n \|]
 .RB [\| \-\-ignore-fatal-sense \|]
 .RB [\| \-\-internal-rereads
 .IR n \|]
-.RB [\| \-\-query-size
+.RB [\| \-\-old-ds-marker \|]
+.RB [\| \-\-prefetch-sectors
 .IR n \|]
 .RB [\| \-\-raw-mode
 .IR n \|]
@@ -46,7 +56,6 @@ DVDISASTER \- data loss/scratch/aging protection for CD/DVD media
 .IR n \|]
 .RB [\| \-\-spinup\-delay
 .IR n \|]
-.RB [\| \-\-split\-files \|]
 
 .SH DESCRIPTION
 .B DVDISASTER
@@ -114,8 +123,10 @@ Try to fix medium image using .ecc information.
 .B \-s, \-\-scan
 Scan the medium for read errors.
 .TP
-.B \-t, \-\-test
-Test integrity of the .iso and .ecc files.
+.B \-t, \-\-test, \-tq, \-\-test=q
+Test integrity of the .iso and .ecc files. When the
+"q" option is given, only information is output
+which can be gathered without fully scanning the files.
 .TP
 .B \-u, \-\-unlink
 Delete .iso files (when other actions complete).
@@ -135,12 +146,24 @@ name of image file (default: medium.iso).
 .B \-e, \-\-ecc eccfile
 name of parity file (default: medium.ecc).
 .TP
-.B \-\-list
-lists available drives for the ASPI driver (Windows only).
-.PP
+.B \-o, \-\-ecc-target file|image
+Specifies whether RS03 should create error correction files
+or augmented images (default: image).
+.TP
 
 Tweaking options (see manual before using!):
 .TP
+.B \-a, \-\-assume codec1,codec2,...
+Assumes that the image is augmented with one of the given codecs.
+This enables an exhaustive search for codec signatures
+and might be helpful for detecting error correction information on
+damaged media. If the image does
+not contain the specified error correction information, a significant
+amount of CPU and I/O time may be wasted.
+.RS
+Possible values are RS02 and RS03.
+.RE
+.TP
 .B \-j, \-\-jump n
 jump n sectors forward after a read error (default: 16).
 .TP
@@ -156,6 +179,12 @@ Possible values are RS01 and RS02.
 .B \-v, \-\-verbose n%
 more diagnostic messages
 .TP
+.B \-x, \-\-threads n
+Use n threads for the RS03 codec. Use 2 or 4 threads for 2 or 4 core 
+processors respectively.
+On larger machines save one core for housekeeping; e.g. use 7 threads
+on an eight core machine.
+.TP
 .B \-\-adaptive-read
 use optimized strategy for reading damaged media.
 .TP
@@ -168,6 +197,14 @@ image cache size in MB during -c mode (default: 32MB).
 .B \-\-dao
 assume DAO disc; do not trim image end.
 .TP
+.B \-\-defective-dump d
+Specifies the sub directory for storing incomplete raw sectors.
+.TP
+.B \-\-driver d (Linux only)
+dvdisaster uses the optical drive interface by default. This may cause
+system failures on some ancient SCSI controllers. Try using the generic
+SCSI driver with the option \-\-driver=sg in such cases.
+.TP
 .B \-\-eject
 eject medium after successful read.
 .TP
@@ -186,10 +223,22 @@ and manage read attempts through the --read-attempts parameter. Most drives igno
 this setting anyways. Use -1 to leave the drive at its default setting.
 .RE
 .TP
-.B \-\-query-size n
-queries drive or filesystem on medium for image size (default: ecc)
+.B \-\-old-ds-marker
+Marks missing sectors in a manner which is compatible with
+dvdisaster 0.70 or older.
 .RS
-Possible values are: drive udf ecc 
+The default marking method is recommended for dvdisaster 0.72 and later
+versions. However images marked with the current method can not
+be processed with older dvdisaster versions as missing sectors
+would not be recognized in the image. 
+
+Do not process the same image with different settings for this option.
+.RE
+.TP
+.B \-\-prefetch-sectors n
+number of sectors to preload during RS03 de-/encoding (default: 32)
+.RS
+Using a value of n uses approx. n MB of RAM.
 .RE
 .TP
 .B \-\-raw-mode n
@@ -216,9 +265,6 @@ print warning if speed changes by more than n percent.
 .TP
 .B \-\-spinup-delay n
 wait n seconds for drive to spin up.
-.TP
-.B \-\-split-files
-split image into files <= 2GB.
 .PP
 
 .SH SEE ALSO
@@ -231,4 +277,4 @@ DVDISASTER was written by Carsten Gnoerlich <carsten@dvdisaster.com>.
 .PP
 This manual page was written by Daniel Baumann
 <daniel.baumann@panthera-systems.net>, for the Debian project (but may be used
-by others). It was enhanced for V0.70/0.72 by Carsten Gnoerlich.
+by others). Since version 0.70 it is maintained by Carsten Gnoerlich.