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