8" cd-paranoia [options] <span> [outfile]\n"
11" -A --analyze-drive : run and log a complete analysis of drive\n"
12" caching, timing and reading behavior;\n"
13" verifies that cdparanoia is correctly\n"
14" modelling a specific drive's cache and\n"
15" read behavior. Implies -vQL\n"
17" -v --verbose : extra verbose operation\n"
18" -q --quiet : quiet operation\n"
19" -e --stderr-progress : force output of progress information to\n"
20" -l --log-summary <file> : save result summary to file\n"
21" stderr (for wrapper scripts)\n"
22" -L --log-debug <file> : save detailed device autosense and\n"
23" debugging output to file\n"
24" stderr (for wrapper scripts)\n"
25" -V --version : print version info and quit\n"
26" -Q --query : autosense drive, query disc and quit\n"
27" -B --batch : 'batch' mode (saves each track to a\n"
29" -s --search-for-drive : do an exhaustive search for drive\n"
30" -h --help : print help\n"
32" -p --output-raw : output raw 16 bit PCM in host byte \n"
34" -r --output-raw-little-endian : output raw 16 bit little-endian PCM\n"
35" -R --output-raw-big-endian : output raw 16 bit big-endian PCM\n"
36" -w --output-wav : output as WAV file (default)\n"
37" -f --output-aiff : output as AIFF file\n"
38" -a --output-aifc : output as AIFF-C file\n"
40" -c --force-cdrom-little-endian : force treating drive as little endian\n"
41" -C --force-cdrom-big-endian : force treating drive as big endian\n"
42" -n --force-default-sectors <n> : force default number of sectors in read\n"
44" -o --force-search-overlap <n> : force minimum overlap search during\n"
45" verification to n sectors\n"
46" -d --force-cdrom-device <dev> : use specified device; disallow \n"
48" -k --force-cooked-device <dev> : really an alias for -d. Kept for \n"
50" -g --force-generic-device <dev> : really an alias for -d. Kept for \n"
52" -S --force-read-speed <n> : read from device at specified speed; by\n"
53" default, cdparanoia sets drive to full\n"
55" -t --toc-offset <n> : Add <n> sectors to the values reported\n"
56" when addressing tracks. May be negative\n"
57" -T --toc-bias : Assume that the beginning offset of \n"
58" track 1 as reported in the TOC will be\n"
59" addressed as LBA 0. Necessary for some\n"
60" Toshiba drives to get track boundaries\n"
62" -m --mmc-timeout <n> : Set SCSI-MMC timeout to <n> seconds.\n"
63" -O --sample-offset <n> : Add <n> samples to the offset when\n"
64" reading data. May be negative.\n"
65" -z --never-skip[=n] : never accept any less than perfect\n"
66" data reconstruction (don't allow 'V's)\n"
67" but if [n] is given, skip after [n]\n"
68" retries without progress.\n"
69" -Z --disable-paranoia : disable all paranoia checking\n"
70" -Y --disable-extra-paranoia : only do cdda2wav-style overlap checking\n"
71" -X --abort-on-skip : abort on imperfect reads/skips\n"
72" -x --test-flags=mask : simulate CD-reading errors of ilk-mask n\n"
73" mask & 0x10 - simulate underrun errors\n"
76" :-) Normal operation, low/no jitter\n"
77" :-| Normal operation, considerable jitter\n"
79" :-P Unreported loss of streaming in atomic read operation\n"
80" 8-| Finding read problems at same point during reread; hard to correct\n"
81" :-0 SCSI/ATAPI transport error\n"
82" :-( Scratch detected\n"
83" ;-( Gave up trying to perform a correction\n"
84" 8-X Aborted (as per -X) due to a scratch/skip\n"
85" :^D Finished extracting\n"
87"PROGRESS BAR SYMBOLS:\n"
88"<space> No corrections needed\n"
89" - Jitter correction required\n"
90" + Unreported loss of streaming/other error in read\n"
91" ! Errors are getting through stage 1 but corrected in stage2\n"
92" e SCSI/ATAPI transport error (corrected)\n"
93" V Uncorrected error/skip\n"
96"The span argument may be a simple track number or a offset/span\n"
97"specification. The syntax of an offset/span takes the rough form:\n"
99" 1[ww:xx:yy.zz]-2[aa:bb:cc.dd] \n"
101"Here, 1 and 2 are track numbers; the numbers in brackets provide a\n"
102"finer grained offset within a particular track. [aa:bb:cc.dd] is in\n"
103"hours/minutes/seconds/sectors format. Zero fields need not be\n"
104"specified: [::20], [:20], [20], [20.], etc, would be interpreted as\n"
105"twenty seconds, [10:] would be ten minutes, [.30] would be thirty\n"
106"sectors (75 sectors per second).\n"
108"When only a single offset is supplied, it is interpreted as a starting\n"
109"offset and ripping will continue to the end of he track. If a single\n"
110"offset is preceeded or followed by a hyphen, the implicit missing\n"
111"offset is taken to be the start or end of the disc, respectively. Thus:\n"
113" 1:[20.35] Specifies ripping from track 1, second 20, sector 35 to \n"
114" the end of track 1.\n"
116" 1:[20.35]- Specifies ripping from 1[20.35] to the end of the disc\n"
118" -2 Specifies ripping from the beginning of the disc up to\n"
119" (and including) track 2\n"
121" -2:[30.35] Specifies ripping from the beginning of the disc up to\n"
124" 2-4 Specifies ripping from the beginning of track two to the\n"
127"Don't forget to protect square brackets and preceeding hyphens from\n"
130"A few examples, protected from the shell:\n"
131" A) query only with exhaustive search for a drive and full reporting\n"
135" B) extract up to and including track 3, putting each track in a seperate\n"
137" cd-paranoia -B -- \"-3\"\n"
139" C) extract from track 1, time 0:30.12 to 1:10.00:\n"
140" cd-paranoia \"[:30.12]-1[1:10]\"\n"
142"Submit bug reports to bug-libcdio@gnu.org\n"
const char usage_help[]
Definition: usage-copy.h:6
