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 -v --verbose
29 Be absurdly verbose about the autosensing and reading process.
30 Good for setup and debugging.
31 -q --quiet
34 Do not print any progress or error information during the read‐
35 ing process.
36 -e --stderr-progress
39 Force output of progress information to stderr (for wrapper
40 scripts).
41 -V --version
44 Print the program version and quit.
45 -Q --query
48 Perform CD-ROM drive autosense, query and print the CD-ROM table
49 of contents, then quit.
50 -s --search-for-drive
53 Forces a complete search for a cdrom drive, even if the
54 /dev/cdrom link exists.
55 -h --help
58 Print a brief synopsis of cd-paranoia usage and options.
59 -l --log-summary file
62 Save result summary to file.
63 -p --output-raw
66 Output headerless data as raw 16 bit PCM data with interleaved
67 samples in host byte order. To force little or big endian byte
68 order, use -r or -R as described below.
69 -r --output-raw-little-endian
72 Output headerless data as raw 16 bit PCM data with interleaved
73 samples in LSB first byte order.
74 -R --output-raw-big-endian
77 Output headerless data as raw 16 bit PCM data with interleaved
78 samples in MSB first byte order.
79 -w --output-wav
82 Output data in Micro$oft RIFF WAV format (note that WAV data is
83 always LSB first byte order).
84 -f --output-aiff
87 Output data in Apple AIFF format (note that AIFC data is always
88 in MSB first byte order).
89 -a --output-aifc
92 Output data in uncompressed Apple AIFF-C format (note that AIFF-
93 C data is always in MSB first byte order).
94 -B --batch
97 Cdda2wav-style batch output flag; cd-paranoia will split the
99 output into multiple files at track boundaries. Output file
100 names are prepended with 'track#.'
101 -c --force-cdrom-little-endian
104 Some CD-ROM drives misreport their endianness (or do not report
105 it at all); it's possible that cd-paranoia will guess wrong.
106 Use -c to force cd-paranoia to treat the drive as a little
107 endian device.
108 -C --force-cdrom-big-endian
111 As above but force cd-paranoia to treat the drive as a big
112 endian device.
113 -n --force-default-sectors n
116 Force the interface backend to do atomic reads of n sectors per
117 read. This number can be misleading; the kernel will often
118 split read requests into multiple atomic reads (the automated
119 Paranoia code is aware of this) or allow reads only wihin a
120 restricted size range. This option should generally not be
121 used.
122 -d --force-cdrom-device device
125 Force the interface backend to read from device rather than the
126 first readable CD-ROM drive it finds containing a CD-DA disc.
127 This can be used to specify devices of any valid interface type
128 (ATAPI, SCSI or proprietary).
129 -g --force-generic-device device
132 This option is an alias for -d and is retained for compatibil‐
133 ity.
134 -S --force-read-speed number
137 Use this option explicitly to set the read rate of the CD drive
138 (where supported). This can reduce underruns on machines with
139 slow disks, or which are low on memory.
140 -t --toc-offset number
143 Use this option to force the entire disc LBA addressing to shift
144 by the given amount; the value is added to the beginning offsets
145 in the TOC. This can be used to shift track boundaries for the
146 whole disc manually on sector granularity. The next option does
147 something similar...
148 -T --toc-bias
151 Some drives (usually random Toshibas) report the actual track
152 beginning offset values in the TOC, but then treat the beginning
153 of track 1 index 1 as sector 0 for all read operations. This
154 results in every track seeming to start too late (losing a bit
155 of the beginning and catching a bit of the next track). -T
156 accounts for this behavior. Note that this option will cause
157 cd-paranoia to attempt to read sectors before or past the known
158 user data area of the disc, resulting in read errors at disc
159 edges on most drives and possibly even hard lockups on some
160 buggy hardware.
161 -O --sample-offset number
164 Some CD-ROM/CD-R drives will add an offset to the position on
165 reading audio data. This is usually around 500-700 audio samples
166 (ca. 1/75 second) on reading. So when cd-paranoia queries a spe‐
167 cific sector, it might not receive exactly that sector, but
168 shifted by some amount.
169 Use this option to force the entire disc to shift sample position out‐
171 put by the given amount; This can be used to shift track boundaries for
172 the whole disc manually on sample granularity. Note that if you are
173 ripping something including the ending of the CD (e.g. the entire
174 disk), this option will cause cd-paranoia to attempt to read partial
175 sectors before or past the known user data area, probably causing read
176 errors on most drives and possibly even hard lockups on some buggy
177 hardware.
178 -Z --disable-paranoia
181 Disable all data verification and correction features. When
182 using -Z, cd-paranoia reads data exactly as would cdda2wav with
183 an overlap setting of zero. This option implies that -Y is
184 active.
185 -z --never-skip[=max_retries]
188 Do not accept any skips; retry forever if needed. An optional
189 maximum number of retries can be specified; for comparison,
190 default without -z is currently 20.
191 -Y --disable-extra-paranoia
194 Disables intra-read data verification; only overlap checking at
195 read boundaries is performed. It can wedge if errors occur in
196 the attempted overlap area. Not recommended.
197 -X --abort-on-skip
200 If the read skips due to imperfect data, a scratch, whatever,
201 abort reading this track. If output is to a file, delete the
202 partially completed file.
203 -x --test-flags mask
206 Simulate CD-reading errors. This is used in regression testing,
207 but other uses might be to see how well a CD-ROM performs under
208 (simulated) CD degradation. mask specifies the artificial kinds
209 of errors to introduced; "or"-ing values from the selection
210 below will simulate the kind of specified failure.
211 0x10 - Simulate under-run reading
213 OUTPUT SMILIES
218 :-) 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 cd-paranoia 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 cd-paranoia -vsQ
309 Extract an entire disc, putting each track in a seperate file:
311 cd-paranoia -B
313 Extract from track 1, time 0:30.12 to 1:10.00:
315 cd-paranoia "1[:30.12]-1[1:10]"
317 Extract from the beginning of the disc up to track 3:
319 cd-paranoia -- "-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, cd-para‐
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 cd-paranoia sprang from and once drew heavily from the interface of
334 Heiko Eissfeldt's (heiko@colossus.escape.de) 'cdda2wav' package. cd-
335 paranoia 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 Revised for use with libcdio by Rocky <rocky@gnu.org>
346 The libcdio homepage may be found at: http://www.gnu.org/software/libc‐
348 dio
349 version III release alpha 9.8 libcdio cd-paranoia(1)