1CDPARANOIA(1) General Commands Manual CDPARANOIA(1)
2
6 cdparanoia 10.2 (Paranoia release III) - an audio CD reading utility
7 which includes extra data verification features
8
10 cdparanoia [options] span [outfile]
11
13 cdparanoia retrieves audio tracks from CDDA capable CDROM drives. The
14 data can be saved to a file or directed to standard output in WAV,
15 AIFF, AIFF-C or raw format. Most ATAPI, SCSI and several proprietary
16 CDROM drive makes are supported; cdparanoia can determine if the target
17 drive is CDDA capable.
18 In addition to simple reading, cdparanoia adds extra-robust data veri‐
20 fication, synchronization, error handling and scratch reconstruction
21 capability.
22
24 -A --analyze-drive
25 Run and log a complete analysis of drive caching, timing and
26 reading behavior; verifies that cdparanoia is correctly model‐
27 ling a sprcific drive's cache and read behavior. Implies -vQL.
28 -v --verbose
31 Be absurdly verbose about the autosensing and reading process.
32 Good for setup and debugging.
33 -q --quiet
36 Do not print any progress or error information during the read‐
37 ing process.
38 -e --stderr-progress
41 Force output of progress information to stderr (for wrapper
42 scripts).
43 -l --log-summary [file]
46 Save result summary to file, default filename cdparanoia.log.
47 -L --log-debug [file]
50 Save detailed device autosense and debugging output to a file,
51 default filename cdparanoia.log.
52 -V --version
55 Print the program version and quit.
56 -Q --query
59 Perform CDROM drive autosense, query and print the CDROM table
60 of contents, then quit.
61 -s --search-for-drive
64 Forces a complete search for a cdrom drive, even if the
65 /dev/cdrom link exists.
66 -h --help
69 Print a brief synopsis of cdparanoia usage and options.
70 -p --output-raw
73 Output headerless data as raw 16 bit PCM data with interleaved
74 samples in host byte order. To force little or big endian byte
75 order, use -r or -R as described below.
76 -r --output-raw-little-endian
79 Output headerless data as raw 16 bit PCM data with interleaved
80 samples in LSB first byte order.
81 -R --output-raw-big-endian
84 Output headerless data as raw 16 bit PCM data with interleaved
85 samples in MSB first byte order.
86 -w --output-wav
89 Output data in Micro$oft RIFF WAV format (note that WAV data is
90 always LSB first byte order).
91 -f --output-aiff
94 Output data in Apple AIFF format (note that AIFC data is always
95 in MSB first byte order).
96 -a --output-aifc
99 Output data in uncompressed Apple AIFF-C format (note that AIFF-
100 C data is always in MSB first byte order).
101 -B --batch
104 Cdda2wav-style batch output flag; cdparanoia will split the out‐
106 put into multiple files at track boundaries. Output file names
107 are prepended with 'track#.'
108 -c --force-cdrom-little-endian
111 Some CDROM drives misreport their endianness (or do not report
112 it at all); it's possible that cdparanoia will guess wrong. Use
113 -c to force cdparanoia to treat the drive as a little endian
114 device.
115 -C --force-cdrom-big-endian
118 As above but force cdparanoia to treat the drive as a big endian
119 device.
120 -n --force-default-sectors n
123 Force the interface backend to do atomic reads of n sectors per
124 read. This number can be misleading; the kernel will often
125 split read requests into multiple atomic reads (the automated
126 Paranoia code is aware of this) or allow reads only wihin a
127 restricted size range. This option should generally not be
128 used.
129 -d --force-cdrom-device device
132 Force the interface backend to read from device rather than the
133 first readable CDROM drive it finds. This can be used to spec‐
134 ify devices of any valid interface type (ATAPI, SCSI or propri‐
135 etary).
136 -k --force-cooked-device device
139 This option forces use of the old 'cooked ioctl' kernel inter‐
140 face with the specified cdrom device. The cooked ioctl inter‐
141 face is obsolete in Linux 2.6 if it is present at all. -k can‐
142 not be used with -d or -g.
143 -g --force-generic-device device
147 This option forces use of the old 'generic scsi' (sg) kernel
148 interface with the specified generic scsi device. -g cannot be
149 used with -k. -g may be used with -d to explicitly set both the
150 SCSI cdrom and generic (sg) devices seperately. This option is
151 only useful on obsolete SCSI setups and when using the generic
152 scsi (sg) driver.
153 -S --force-read-speed number
156 Use this option explicitly to set the read rate of the CD drive
157 (where supported). This can reduce underruns on machines with
158 slow disks, or which are low on memory.
159 -t --toc-offset number
162 Use this option to force the entire disc LBA addressing to shift
163 by the given amount; the value is added to the beginning offsets
164 in the TOC. This can be used to shift track boundaries for the
165 whole disc manually on sector granularity. The next option does
166 something similar...
167 -T --toc-bias
170 Some drives (usually random Toshibas) report the actual track
171 beginning offset values in the TOC, but then treat the beginning
172 of track 1 index 1 as sector 0 for all read operations. This
173 results in every track seeming to start too late (losing a bit
174 of the beginning and catching a bit of the next track). -T
175 accounts for this behavior. Note that this option will cause
176 cdparanoia to attempt to read sectors before or past the known
177 user data area of the disc, resulting in read errors at disc
178 edges on most drives and possibly even hard lockups on some
179 buggy hardware.
180 -O --sample-offset number
183 Use this option to force the entire disc to shift sample posi‐
184 tion output by the given amount; This can be used to shift track
185 boundaries for the whole disc manually on sample granularity.
186 Note that this will cause cdparanoia to attempt to read partial
187 sectors before or past the known user data area of the disc,
188 probably causing read errors on most drives and possibly even
189 hard lockups on some buggy hardware.
190 -Z --disable-paranoia
194 Disable all data verification and correction features. When
195 using -Z, cdparanoia reads data exactly as would cdda2wav with
196 an overlap setting of zero. This option implies that -Y is
197 active.
198 -z --never-skip[=max_retries]
201 Do not accept any skips; retry forever if needed. An optional
202 maximum number of retries can be specified; for comparison,
203 default without -z is currently 20.
204 -Y --disable-extra-paranoia
207 Disables intra-read data verification; only overlap checking at
208 read boundaries is performed. It can wedge if errors occur in
209 the attempted overlap area. Not recommended.
210 -X --abort-on-skip
213 If the read skips due to imperfect data, a scratch, whatever,
214 abort reading this track. If output is to a file, delete the
215 partially completed file.
216
219 :-) Normal operation, low/no jitter
220 :-| Normal operation, considerable jitter
222 :-/ Read drift
224 :-P Unreported loss of streaming in atomic read operation
226 8-| Finding read problems at same point during reread; hard to cor‐
228 rect
229 :-0 SCSI/ATAPI transport error
231 :-( Scratch detected
233 ;-( Gave up trying to perform a correction
235 8-X Aborted read due to known, uncorrectable error
237 :^D Finished extracting
239
242 <space>
243 No corrections needed
244 - Jitter correction required
246 + Unreported loss of streaming/other error in read
248 ! Errors found after stage 1 correction; the drive is making the
250 same error through multiple re-reads, and cdparanoia is having
251 trouble detecting them.
252 e SCSI/ATAPI transport error (corrected)
254 V Uncorrected error/skip
256
259 The span argument specifies which track, tracks or subsections of
260 tracks to read. This argument is required. NOTE: Unless the span is a
261 simple number, it's generally a good idea to quote the span argument to
262 protect it from the shell.
263 The span argument may be a simple track number or an offset/span speci‐
265 fication. The syntax of an offset/span takes the rough form:
266 1[ww:xx:yy.zz]-2[aa:bb:cc.dd]
268 Here, 1 and 2 are track numbers; the numbers in brackets provide a
270 finer grained offset within a particular track. [aa:bb:cc.dd] is in
271 hours/minutes/seconds/sectors format. Zero fields need not be speci‐
272 fied: [::20], [:20], [20], [20.], etc, would be interpreted as twenty
273 seconds, [10:] would be ten minutes, [.30] would be thirty sectors (75
274 sectors per second).
275 When only a single offset is supplied, it is interpreted as a starting
277 offset and ripping will continue to the end of the track. If a single
278 offset is preceeded or followed by a hyphen, the implicit missing off‐
279 set is taken to be the start or end of the disc, respectively. Thus:
280 1:[20.35]
283 Specifies ripping from track 1, second 20, sector 35 to the end
284 of track 1.
285 1:[20.35]-
287 Specifies ripping from 1[20.35] to the end of the disc
288 -2 Specifies ripping from the beginning of the disc up to (and
290 including) track 2
291 -2:[30.35]
293 Specifies ripping from the beginning of the disc up to 2:[30.35]
294 2-4 Specifies ripping from the beginning of track 2 to the end of
296 track 4.
297 Again, don't forget to protect square brackets and preceeding hyphens
299 from the shell.
300
303 A few examples, protected from the shell:
304 Query only with exhaustive search for a drive and full reporting of
306 autosense:
307 cdparanoia -vsQ
309 Extract an entire disc, putting each track in a seperate file:
311 cdparanoia -B
313 Extract from track 1, time 0:30.12 to 1:10.00:
315 cdparanoia "1[:30.12]-1[1:10]"
317 Extract from the beginning of the disc up to track 3:
319 cdparanoia -- "-3"
321 The "--" above is to distinguish "-3" from an option flag.
323
325 The output file argument is optional; if it is not specified, cdpara‐
326 noia will output samples to one of cdda.wav, cdda.aifc, or cdda.raw
327 depending on whether -w, -a, -r or -R is used (-w is the implicit
328 default). The output file argument of - specifies standard output; all
329 data formats may be piped.
330
333 Cdparanoia sprang from and once drew heavily from the interface of
334 Heiko Eissfeldt's (heiko@colossus.escape.de) 'cdda2wav' package.
335 Cdparanoia would not have happened without it.
336 Joerg Schilling has also contributed SCSI expertise through his generic
338 SCSI transport library.
339
341 Monty <monty@xiph.org>
342 Cdparanoia's homepage may be found at: http://www.xiph.org/paranoia/
344 11 Sep 2008 CDPARANOIA(1)