libcdio-paranoia 10.2+2.0.2
usage-copy.h
Go to the documentation of this file.
1/*
2 Copyright (C) 1999, 2005, 2008, 2009 Rocky Bernstein
3 Copyright (C) 2014 Robert Kausch <robert.kausch@freac.org>
4*/
5
6const char usage_help[] =
7"USAGE:\n"
8" cd-paranoia [options] <span> [outfile]\n"
9"\n"
10"OPTIONS:\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"
16"\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"
28" seperate file.\n"
29" -s --search-for-drive : do an exhaustive search for drive\n"
30" -h --help : print help\n"
31"\n"
32" -p --output-raw : output raw 16 bit PCM in host byte \n"
33" order\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"
39"\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"
43" to n sectors\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"
47" autosense\n"
48" -k --force-cooked-device <dev> : really an alias for -d. Kept for \n"
49" compatibility.\n"
50" -g --force-generic-device <dev> : really an alias for -d. Kept for \n"
51" compatibility.\n"
52" -S --force-read-speed <n> : read from device at specified speed; by\n"
53" default, cdparanoia sets drive to full\n"
54" speed.\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"
61" correct\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"
74"\n"
75"OUTPUT SMILIES:\n"
76" :-) Normal operation, low/no jitter\n"
77" :-| Normal operation, considerable jitter\n"
78" :-/ Read drift\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"
86"\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"
94"\n"
95"SPAN ARGUMENT:\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"
98" \n"
99" 1[ww:xx:yy.zz]-2[aa:bb:cc.dd] \n"
100"\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"
107"\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"
112"\n"
113" 1:[20.35] Specifies ripping from track 1, second 20, sector 35 to \n"
114" the end of track 1.\n"
115"\n"
116" 1:[20.35]- Specifies ripping from 1[20.35] to the end of the disc\n"
117"\n"
118" -2 Specifies ripping from the beginning of the disc up to\n"
119" (and including) track 2\n"
120"\n"
121" -2:[30.35] Specifies ripping from the beginning of the disc up to\n"
122" 2:[30.35]\n"
123"\n"
124" 2-4 Specifies ripping from the beginning of track two to the\n"
125" end of track 4.\n"
126"\n"
127"Don't forget to protect square brackets and preceeding hyphens from\n"
128"the shell...\n"
129"\n"
130"A few examples, protected from the shell:\n"
131" A) query only with exhaustive search for a drive and full reporting\n"
132" of autosense:\n"
133" cd-paranoia -vsQ\n"
134"\n"
135" B) extract up to and including track 3, putting each track in a seperate\n"
136" file:\n"
137" cd-paranoia -B -- \"-3\"\n"
138"\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"
141"\n"
142"Submit bug reports to bug-libcdio@gnu.org\n"
143"\n"
144;
const char usage_help[]
Definition: usage-copy.h:6