DATE
version III release alpha 9.8 (02 Mar 2001)
SYNOPSIS
cdparanoia [options] span [outfile]
DESCRIPTION
cdparanoia retrieves audio tracks from CDDA capable CDROM
drives. The data can be saved to a file or directed to
standard output in WAV, AIFF, AIFF-C or raw format. Most
ATAPI, SCSI and several proprietary CDROM drive makes are
supported; cdparanoia can determine if the target drive is
CDDA capable.
In addition to simple reading, cdparanoia adds extra-
robust data verification, synchronization, error handling
and scratch reconstruction capability.
OPTIONS
-v --verbose
Be absurdly verbose about the autosensing and read
ing process. Good for setup and debugging.
-q --quiet
Do not print any progress or error information dur
ing the reading process.
-e --stderr-progress
Force output of progress information to stderr (for
wrapper scripts).
-V --version
Print the program version and quit.
-Q --query
Perform CDROM drive autosense, query and print the
CDROM table of contents, then quit.
-s --search-for-drive
Forces a complete search for a cdrom drive, even if
the /dev/cdrom link exists.
-h --help
Print a brief synopsis of cdparanoia usage and
options.
-R --output-raw-big-endian
Output headerless data as raw 16 bit PCM data with
interleaved samples in MSB first byte order.
-w --output-wav
Output data in Micro$oft RIFF WAV format (note that
WAV data is always LSB first byte order).
-f --output-aiff
Output data in Apple AIFF format (note that AIFC
data is always in MSB first byte order).
-a --output-aifc
Output data in uncompressed Apple AIFF-C format
(note that AIFF-C data is always in MSB first byte
order).
-B --batch
Cdda2wav-style batch output flag; cdparanoia will
split the output into multiple files at track
boundaries. Output file names are prepended with
'track#.'
-c --force-cdrom-little-endian
Some CDROM drives misreport their endianness (or do
not report it at all); it's possible that cdpara
noia will guess wrong. Use -c to force cdparanoia
to treat the drive as a little endian device.
-C --force-cdrom-big-endian
As above but force cdparanoia to treat the drive as
a big endian device.
-n --force-default-sectors n
Force the interface backend to do atomic reads of n
sectors per read. This number can be misleading;
the kernel will often split read requests into mul
tiple atomic reads (the automated Paranoia code is
aware of this) or allow reads only wihin a
restricted size range. This option should gener
ally not be used.
-d --force-cdrom-device device
Use this option explicitly to set the read rate of
the CD drive (where supported). This can reduce
underruns on machines with slow disks, or which are
low on memory.
-t --toc-offset number
Use this option to force the entire disc LBA
addressing to shift by the given amount; the value
is added to the beginning offsets in the TOC. This
can be used to shift track boundaries for the whole
disc manually on sector granularity. The next
option does something similar...
-T --toc-bias
Some drives (usually random Toshibas) report the
actual track beginning offset values in the TOC,
but then treat the beginning of track 1 index 1 as
sector 0 for all read operations. This results in
every track seeming to start too late (losing a bit
of the beginning and catching a bit of the next
track). -T accounts for this behavior. Note that
this option will cause cdparanoia to attempt to
read sectors before or past the known user data
area of the disc, resulting in read errors at disc
edges on most drives and possibly even hard lockups
on some buggy hardware.
-O --sample-offset number
Use this option to force the entire disc to shift
sample position output by the given amount; This
can be used to shift track boundaries for the whole
disc manually on sample granularity. Note that this
will cause cdparanoia to attempt to read partial
sectors before or past the known user data area of
the disc, probably causing read errors on most
drives and possibly even hard lockups on some buggy
hardware.
-Z --disable-paranoia
Disable all data verification and correction fea
tures. When using -Z, cdparanoia reads data
exactly as would cdda2wav with an overlap setting
of zero. This option implies that -Y is active.
-z --never-skip[=max_retries]
Do not accept any skips; retry forever if needed.
whatever, abort reading this track. If output is
to a file, delete the partially completed file.
OUTPUT SMILIES
:-) Normal operation, low/no jitter
:-| Normal operation, considerable jitter
:-/ Read drift
:-P Unreported loss of streaming in atomic read opera
tion
8-| Finding read problems at same point during reread;
hard to correct
:-0 SCSI/ATAPI transport error
:-( Scratch detected
;-( Gave up trying to perform a correction
8-X Aborted read due to known, uncorrectable error
:^D Finished extracting
PROGRESS BAR SYMBOLS
<space>
No corrections needed
- Jitter correction required
+ Unreported loss of streaming/other error in read
! Errors found after stage 1 correction; the drive is
making the same error through multiple re-reads,
and cdparanoia is having trouble detecting them.
e SCSI/ATAPI transport error (corrected)
V Uncorrected error/skip
SPAN ARGUMENT
The span argument specifies which track, tracks or subsec
tions of tracks to read. This argument is required.
NOTE: Unless the span is a simple number, it's generally a
good idea to quote the span argument to protect it from
the shell.
When only a single offset is supplied, it is interpreted
as a starting offset and ripping will continue to the end
of the track. If a single offset is preceeded or followed
by a hyphen, the implicit missing offset is taken to be
the start or end of the disc, respectively. Thus:
1:[20.35]
Specifies ripping from track 1, second 20, sector
35 to the end of track 1.
1:[20.35]-
Specifies ripping from 1[20.35] to the end of the
disc
-2 Specifies ripping from the beginning of the disc up
to (and including) track 2
-2:[30.35]
Specifies ripping from the beginning of the disc up
to 2:[30.35]
2-4 Specifies ripping from the beginning of track 2 to
the end of track 4.
Again, don't forget to protect square brackets and pre
ceeding hyphens from the shell.
EXAMPLES
A few examples, protected from the shell:
Query only with exhaustive search for a drive and full
reporting of autosense:
cdparanoia -vsQ
Extract an entire disc, putting each track in a seperate
file:
cdparanoia -B
Extract from track 1, time 0:30.12 to 1:10.00:
cdparanoia "1[:30.12]-1[1:10]"
Extract from the beginning of the disc up to track 3:
cdparanoia -- "-3"
The "--" above is to distinguish "-3" from an option flag.
Joerg Schilling has also contributed SCSI expertise
through his generic SCSI transport library.
AUTHOR
Monty <monty@xiph.org>
Cdparanoia's homepage may be found at:
http://www.xiph.org/paranoia/
CDPARANOIA(1)
Man(1) output converted with
man2html