1cd-paranoia(1) General Commands Manual cd-paranoia(1)
2
6 cd-paranoia - 9.8 (Paranoia release III via libcdio) - an audio CD
7 reading utility which includes extra data verification features
8
10 cd-paranoia [options] span [outfile]
11
13 cd-paranoia retrieves audio tracks from CDDA capable CD-ROM drives.
14 The 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 CD-ROM drive makes are supported; cd-paranoia can determine if the tar‐
17 get drive is CDDA capable.
18 In addition to simple reading, cd-paranoia adds extra-robust data veri‐
20 fication, synchronization, error handling and scratch reconstruction
21 capability.
22 This version uses the libcdio library for interaction with a CD-ROM
24 drive. The jitter and error correction however are the same as used in
25 Xiph's cdparanoia.
26
28 -A --analyze-drive
29 Run and log a complete analysis of drive caching, timing and
30 reading behavior; verifies that cdparanoia is correctly model‐
31 ling a specific drive's cache and read behavior. Implies -vQL.
32 -v --verbose
35 Be absurdly verbose about the autosensing and reading process.
36 Good for setup and debugging.
37 -q --quiet
40 Do not print any progress or error information during the read‐
41 ing process.
42 -e --stderr-progress
45 Force output of progress information to stderr (for wrapper
46 scripts).
47 -V --version
50 Print the program version and quit.
51 -Q --query
54 Perform CD-ROM drive autosense, query and print the CD-ROM table
55 of contents, then quit.
56 -h --help
59 Print a brief synopsis of cd-paranoia usage and options.
60 -l --log-summary file
63 Save result summary to file.
64 -L --log-debug file
67 Save detailed device autosense and debugging output to a file.
68 -p --output-raw
71 Output headerless data as raw 16 bit PCM data with interleaved
72 samples in host byte order. To force little or big endian byte
73 order, use -r or -R as described below.
74 -r --output-raw-little-endian
77 Output headerless data as raw 16 bit PCM data with interleaved
78 samples in LSB first byte order.
79 -R --output-raw-big-endian
82 Output headerless data as raw 16 bit PCM data with interleaved
83 samples in MSB first byte order.
84 -w --output-wav
87 Output data in Microsoft RIFF WAV format (note that WAV data is
88 always LSB first byte order).
89 -f --output-aiff
92 Output data in Apple AIFF format (note that AIFC data is always
93 in MSB first byte order).
94 -a --output-aifc
97 Output data in uncompressed Apple AIFF-C format (note that AIFF-
98 C data is always in MSB first byte order).
99 -B --batch
102 Cdda2wav-style batch output flag; cd-paranoia will split the
104 output into multiple files at track boundaries. Output file
105 names are prepended with 'track#.'
106 -c --force-cdrom-little-endian
109 Some CD-ROM drives misreport their endianness (or do not report
110 it at all); it's possible that cd-paranoia will guess wrong.
111 Use -c to force cd-paranoia to treat the drive as a little
112 endian device.
113 -C --force-cdrom-big-endian
116 As above but force cd-paranoia to treat the drive as a big
117 endian device.
118 -n --force-default-sectors n
121 Force the interface backend to do atomic reads of n sectors per
122 read. This number can be misleading; the kernel will often
123 split read requests into multiple atomic reads (the automated
124 Paranoia code is aware of this) or allow reads only wihin a
125 restricted size range. This option should generally not be
126 used.
127 -d --force-cdrom-device device
130 Force the interface backend to read from device rather than the
131 first readable CD-ROM drive it finds containing a CD-DA disc.
132 This can be used to specify devices of any valid interface type
133 (ATAPI, SCSI or proprietary).
134 -g --force-generic-device device
137 This option is an alias for -d and is retained for compatibil‐
138 ity.
139 -S --force-read-speed number
142 Use this option explicitly to set the read rate of the CD drive
143 (where supported). This can reduce underruns on machines with
144 slow disks, or which are low on memory.
145 -t --toc-offset number
148 Use this option to force the entire disc LBA addressing to shift
149 by the given amount; the value is added to the beginning offsets
150 in the TOC. This can be used to shift track boundaries for the
151 whole disc manually on sector granularity. The next option does
152 something similar...
153 -T --toc-bias
156 Some drives (usually random Toshibas) report the actual track
157 beginning offset values in the TOC, but then treat the beginning
158 of track 1 index 1 as sector 0 for all read operations. This
159 results in every track seeming to start too late (losing a bit
160 of the beginning and catching a bit of the next track). -T
161 accounts for this behavior. Note that this option will cause
162 cd-paranoia to attempt to read sectors before or past the known
163 user data area of the disc, resulting in read errors at disc
164 edges on most drives and possibly even hard lockups on some
165 buggy hardware.
166 -O --sample-offset number
169 Some CD-ROM/CD-R drives will add an offset to the position on
170 reading audio data. This is usually around 500-700 audio samples
171 (ca. 1/75 second) on reading. So when cd-paranoia queries a spe‐
172 cific sector, it might not receive exactly that sector, but
173 shifted by some amount.
174 Use this option to force the entire disc to shift sample position out‐
176 put by the given amount; This can be used to shift track boundaries for
177 the whole disc manually on sample granularity. Note that if you are
178 ripping something including the ending of the CD (e.g. the entire
179 disk), this option will cause cd-paranoia to attempt to read partial
180 sectors before or past the known user data area, probably causing read
181 errors on most drives and possibly even hard lockups on some buggy
182 hardware.
183 -E--force-overread
186 Force overreading into the lead-out portion of the disc. This
187 option is only applicable when using the +.B -O +option with a
188 positive sample offset value. Many drives are not capable of
189 reading into this portion of the disc and attempting to do so on
190 those drives will produce read errors and possibly hard lockups.
191 -Z --disable-paranoia
194 Disable all data verification and correction features. When
195 using -Z, cd-paranoia 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 -x --test-flags mask
219 Simulate CD-reading errors. This is used in regression testing,
220 but other uses might be to see how well a CD-ROM performs under
221 (simulated) CD degradation. mask specifies the artificial kinds
222 of errors to introduced; "or"-ing values from the selection
223 below will simulate the kind of specified failure.
224 0x10 - Simulate under-run reading
226 OUTPUT SMILIES
231 :-) Normal operation, low/no jitter
233 :-| Normal operation, considerable jitter
235 :-/ Read drift
237 :-P Unreported loss of streaming in atomic read operation
239 8-| Finding read problems at same point during reread; hard to cor‐
241 rect
242 :-0 SCSI/ATAPI transport error
244 :-( Scratch detected
246 ;-( Gave up trying to perform a correction
248 8-X Aborted read due to known, uncorrectable error
250 :^D Finished extracting
252
255 <space>
256 No corrections needed
257 - Jitter correction required
259 + Unreported loss of streaming/other error in read
261 ! Errors found after stage 1 correction; the drive is making the
263 same error through multiple re-reads, and cd-paranoia is having
264 trouble detecting them.
265 e SCSI/ATAPI transport error (corrected)
267 V Uncorrected error/skip
269
272 The span argument specifies which track, tracks or subsections of
273 tracks to read. This argument is required. NOTE: Unless the span is a
274 simple number, it's generally a good idea to quote the span argument to
275 protect it from the shell.
276 The span argument may be a simple track number or an offset/span speci‐
278 fication. The syntax of an offset/span takes the rough form:
279 1[ww:xx:yy.zz]-2[aa:bb:cc.dd]
281 Here, 1 and 2 are track numbers; the numbers in brackets provide a
283 finer grained offset within a particular track. [aa:bb:cc.dd] is in
284 hours/minutes/seconds/sectors format. Zero fields need not be speci‐
285 fied: [::20], [:20], [20], [20.], etc, would be interpreted as twenty
286 seconds, [10:] would be ten minutes, [.30] would be thirty sectors (75
287 sectors per second).
288 When only a single offset is supplied, it is interpreted as a starting
290 offset and ripping will continue to the end of the track. If a single
291 offset is preceeded or followed by a hyphen, the implicit missing off‐
292 set is taken to be the start or end of the disc, respectively. Thus:
293 1:[20.35]
296 Specifies ripping from track 1, second 20, sector 35 to the end
297 of track 1.
298 1:[20.35]-
300 Specifies ripping from 1[20.35] to the end of the disc
301 -2 Specifies ripping from the beginning of the disc up to (and
303 including) track 2
304 -2:[30.35]
306 Specifies ripping from the beginning of the disc up to 2:[30.35]
307 2-4 Specifies ripping from the beginning of track 2 to the end of
309 track 4.
310 Again, don't forget to protect square brackets and preceeding hyphens
312 from the shell.
313
316 A few examples, protected from the shell:
317 Query only with exhaustive search for a drive and full reporting of
319 autosense:
320 cd-paranoia -vsQ
322 Extract an entire disc, putting each track in a separate file:
324 cd-paranoia -B
326 Extract from track 1, time 0:30.12 to 1:10.00:
328 cd-paranoia "1[:30.12]-1[1:10]"
330 Extract from the beginning of the disc up to track 3:
332 cd-paranoia -- "-3"
334 The "--" above is to distinguish "-3" from an option flag.
336
338 The output file argument is optional; if it is not specified, cd-para‐
339 noia will output samples to one of cdda.wav, cdda.aifc, or cdda.raw
340 depending on whether -w, -a, -r or -R is used (-w is the implicit
341 default). The output file argument of - specifies standard output; all
342 data formats may be piped.
343
346 cd-paranoia sprang from and once drew heavily from the interface of
347 Heiko Eissfeldt's (heiko@colossus.escape.de) 'cdda2wav' package. cd-
348 paranoia would not have happened without it.
349 Joerg Schilling has also contributed SCSI expertise through his generic
351 SCSI transport library.
352
354 Monty <monty@xiph.org>
355 Cdparanoia's homepage may be found at: https://www.xiph.org/paranoia/
357 Revised for use with libcdio by Rocky <rocky@gnu.org>
359 The libcdio homepage may be found at: https://www.gnu.org/soft‐
361 ware/libcdio/
362 version III release alpha 9.8 libcdio cd-paranoia(1)