|
Packit |
cb6d3d |
USAGE:
|
|
Packit |
cb6d3d |
@CDPARANOIA_NAME@ [options] [outfile]
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
OPTIONS:
|
|
Packit |
cb6d3d |
-A --analyze-drive : run and log a complete analysis of drive
|
|
Packit |
cb6d3d |
caching, timing and reading behavior;
|
|
Packit |
cb6d3d |
verifies that cdparanoia is correctly
|
|
Packit |
cb6d3d |
modelling a specific drive's cache and
|
|
Packit |
cb6d3d |
read behavior. Implies -vQL
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
-v --verbose : extra verbose operation
|
|
Packit |
cb6d3d |
-q --quiet : quiet operation
|
|
Packit |
cb6d3d |
-e --stderr-progress : force output of progress information to
|
|
Packit |
cb6d3d |
stderr (for wrapper scripts)
|
|
Packit |
cb6d3d |
-l --log-summary <file> : save result summary to file
|
|
Packit |
cb6d3d |
-L --log-debug <file> : save detailed device autosense and
|
|
Packit |
cb6d3d |
debugging output to file
|
|
Packit |
cb6d3d |
-V --version : print version info and quit
|
|
Packit |
cb6d3d |
-Q --query : autosense drive, query disc and quit
|
|
Packit |
cb6d3d |
-B --batch : 'batch' mode (saves each track to a
|
|
Packit |
cb6d3d |
seperate file.
|
|
Packit |
cb6d3d |
-s --search-for-drive : do an exhaustive search for drive
|
|
Packit |
cb6d3d |
-h --help : print help
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
-p --output-raw : output raw 16 bit PCM in host byte
|
|
Packit |
cb6d3d |
order
|
|
Packit |
cb6d3d |
-r --output-raw-little-endian : output raw 16 bit little-endian PCM
|
|
Packit |
cb6d3d |
-R --output-raw-big-endian : output raw 16 bit big-endian PCM
|
|
Packit |
cb6d3d |
-w --output-wav : output as WAV file (default)
|
|
Packit |
cb6d3d |
-f --output-aiff : output as AIFF file
|
|
Packit |
cb6d3d |
-a --output-aifc : output as AIFF-C file
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
-c --force-cdrom-little-endian : force treating drive as little endian
|
|
Packit |
cb6d3d |
-C --force-cdrom-big-endian : force treating drive as big endian
|
|
Packit |
cb6d3d |
-n --force-default-sectors <n> : force default number of sectors in read
|
|
Packit |
cb6d3d |
to n sectors
|
|
Packit |
cb6d3d |
-o --force-search-overlap <n> : force minimum overlap search during
|
|
Packit |
cb6d3d |
verification to n sectors
|
|
Packit |
cb6d3d |
-d --force-cdrom-device <dev> : use specified device; disallow
|
|
Packit |
cb6d3d |
autosense
|
|
Packit |
cb6d3d |
-k --force-cooked-device <dev> : really an alias for -d. Kept for
|
|
Packit |
cb6d3d |
compatibility.
|
|
Packit |
cb6d3d |
-g --force-generic-device <dev> : really an alias for -d. Kept for
|
|
Packit |
cb6d3d |
compatibility.
|
|
Packit |
cb6d3d |
-S --force-read-speed <n> : read from device at specified speed; by
|
|
Packit |
cb6d3d |
default, cdparanoia sets drive to full
|
|
Packit |
cb6d3d |
speed.
|
|
Packit |
cb6d3d |
-t --toc-offset <n> : Add <n> sectors to the values reported
|
|
Packit |
cb6d3d |
when addressing tracks. May be negative
|
|
Packit |
cb6d3d |
-T --toc-bias : Assume that the beginning offset of
|
|
Packit |
cb6d3d |
track 1 as reported in the TOC will be
|
|
Packit |
cb6d3d |
addressed as LBA 0. Necessary for some
|
|
Packit |
cb6d3d |
Toshiba drives to get track boundaries
|
|
Packit |
cb6d3d |
correct
|
|
Packit |
cb6d3d |
-m --mmc-timeout <n> : Set SCSI-MMC timeout to <n> seconds.
|
|
Packit |
cb6d3d |
-O --sample-offset <n> : Add <n> samples to the offset when
|
|
Packit |
cb6d3d |
reading data. May be negative.
|
|
Packit |
cb6d3d |
-z --never-skip[=n] : never accept any less than perfect
|
|
Packit |
cb6d3d |
data reconstruction (don't allow 'V's)
|
|
Packit |
cb6d3d |
but if [n] is given, skip after [n]
|
|
Packit |
cb6d3d |
retries without progress.
|
|
Packit |
cb6d3d |
-Z --disable-paranoia : disable all paranoia checking
|
|
Packit |
cb6d3d |
-Y --disable-extra-paranoia : only do cdda2wav-style overlap checking
|
|
Packit |
cb6d3d |
-X --abort-on-skip : abort on imperfect reads/skips
|
|
Packit |
cb6d3d |
-x --test-flags=mask : simulate CD-reading errors of ilk-mask n
|
|
Packit |
cb6d3d |
mask & 0x10 - simulate underrun errors
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
OUTPUT SMILIES:
|
|
Packit |
cb6d3d |
:-) Normal operation, low/no jitter
|
|
Packit |
cb6d3d |
:-| Normal operation, considerable jitter
|
|
Packit |
cb6d3d |
:-/ Read drift
|
|
Packit |
cb6d3d |
:-P Unreported loss of streaming in atomic read operation
|
|
Packit |
cb6d3d |
8-| Finding read problems at same point during reread; hard to correct
|
|
Packit |
cb6d3d |
:-0 SCSI/ATAPI transport error
|
|
Packit |
cb6d3d |
:-( Scratch detected
|
|
Packit |
cb6d3d |
;-( Gave up trying to perform a correction
|
|
Packit |
cb6d3d |
8-X Aborted (as per -X) due to a scratch/skip
|
|
Packit |
cb6d3d |
:^D Finished extracting
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
PROGRESS BAR SYMBOLS:
|
|
Packit |
cb6d3d |
<space> No corrections needed
|
|
Packit |
cb6d3d |
- Jitter correction required
|
|
Packit |
cb6d3d |
+ Unreported loss of streaming/other error in read
|
|
Packit |
cb6d3d |
! Errors are getting through stage 1 but corrected in stage2
|
|
Packit |
cb6d3d |
e SCSI/ATAPI transport error (corrected)
|
|
Packit |
cb6d3d |
V Uncorrected error/skip
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
SPAN ARGUMENT:
|
|
Packit |
cb6d3d |
The span argument may be a simple track number or a offset/span
|
|
Packit |
cb6d3d |
specification. The syntax of an offset/span takes the rough form:
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
1[ww:xx:yy.zz]-2[aa:bb:cc.dd]
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
Here, 1 and 2 are track numbers; the numbers in brackets provide a
|
|
Packit |
cb6d3d |
finer grained offset within a particular track. [aa:bb:cc.dd] is in
|
|
Packit |
cb6d3d |
hours/minutes/seconds/sectors format. Zero fields need not be
|
|
Packit |
cb6d3d |
specified: [::20], [:20], [20], [20.], etc, would be interpreted as
|
|
Packit |
cb6d3d |
twenty seconds, [10:] would be ten minutes, [.30] would be thirty
|
|
Packit |
cb6d3d |
sectors (75 sectors per second).
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
When only a single offset is supplied, it is interpreted as a starting
|
|
Packit |
cb6d3d |
offset and ripping will continue to the end of he track. If a single
|
|
Packit |
cb6d3d |
offset is preceeded or followed by a hyphen, the implicit missing
|
|
Packit |
cb6d3d |
offset is taken to be the start or end of the disc, respectively. Thus:
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
1:[20.35] Specifies ripping from track 1, second 20, sector 35 to
|
|
Packit |
cb6d3d |
the end of track 1.
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
1:[20.35]- Specifies ripping from 1[20.35] to the end of the disc
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
-2 Specifies ripping from the beginning of the disc up to
|
|
Packit |
cb6d3d |
(and including) track 2
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
-2:[30.35] Specifies ripping from the beginning of the disc up to
|
|
Packit |
cb6d3d |
2:[30.35]
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
2-4 Specifies ripping from the beginning of track two to the
|
|
Packit |
cb6d3d |
end of track 4.
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
Don't forget to protect square brackets and preceeding hyphens from
|
|
Packit |
cb6d3d |
the shell...
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
A few examples, protected from the shell:
|
|
Packit |
cb6d3d |
A) query only with exhaustive search for a drive and full reporting
|
|
Packit |
cb6d3d |
of autosense:
|
|
Packit |
cb6d3d |
@CDPARANOIA_NAME@ -vsQ
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
B) extract up to and including track 3, putting each track in a separate
|
|
Packit |
cb6d3d |
file:
|
|
Packit |
cb6d3d |
@CDPARANOIA_NAME@ -B -- "-3"
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
C) extract from track 1, time 0:30.12 to 1:10.00:
|
|
Packit |
cb6d3d |
@CDPARANOIA_NAME@ "[:30.12]-1[1:10]"
|
|
Packit |
cb6d3d |
|
|
Packit |
cb6d3d |
Submit bug reports to bug-libcdio@gnu.org
|
|
Packit |
cb6d3d |
|