1CDRDAO(1)                   General Commands Manual                  CDRDAO(1)
2
3
4

NAME

6       cdrdao - reads and writes CDs in disc-at-once mode
7

SYNOPSIS

9       cdrdao   {show-toc|read-toc|read-cd|read-cddb|show-data|read-test|disk-
10       info|msinfo|unlock|simulate|write|copy|blank}     [--device     device]
11       [--source-device  device] [--driver driver-id] [--source-driver driver-
12       id]   [--simulate]   [--speed   writing-speed]   [--blank-mode    mode]
13       [--datafile file] [--read-raw] [--read-subchan [--no-mode2-mixed] mode]
14       [--tao-source] [--tao-source-adjust link-blocks]  [--fast-toc]  [--buf‐
15       fers  buffer-count]  [--multi]  [--overburn] [--eject] [--swap] [--ses‐
16       sion] [--force] [--reload]  [--keepimage]  [--on-the-fly]  [--paranoia-
17       mode  mode]  [--with-cddb] [--cddb-servers server-list] [--cddb-timeout
18       timeout] [--cddb-directory  directory]  [--tmpdir  directory]  [--keep]
19       [--save] [-n] [-v verbose-level] toc-file
20

DESCRIPTION

22       cdrdao  creates  audio and data CD-Rs in disk-at-once (DAO) mode driven
23       by a description file called toc-file.  In DAO mode it is  possible  to
24       create  non standard track pre-gaps that have other lengths than 2 sec‐
25       onds and contain nonzero audio data. This  is  for  example  useful  to
26       divide live recordings into tracks where 2 second gaps would be kind of
27       irritating.
28
29       Instead of a toc-file a cue file (used by a famous DOS/Windows  master‐
30       ing tool) may be used. See the CUE FILES section for more details.
31
32

COMMANDS

34       The first argument must be one of the following commands:
35
36       show-toc
37              Print out a summary about what will be written to the CD-R.
38
39       read-toc
40              Analyze each track of the inserted CD and create a toc-file that
41              can be used to make a more or less exact copy of the  CD.   This
42              command  does not read out the audio or data tracks, use read-cd
43              for this purpose.
44
45              You can specify a filename for the data file via the  --datafile
46              option.
47
48       read-cd
49              Copies  all  tracks of the inserted CD to an image file and cre‐
50              ates a corresponding toc-file.   The  name  of  the  image  file
51              defaults to "data.bin" if no --datafile option is given.
52
53       read-cddb
54              Tries  to  retrieve title and artist data from a CDDB server for
55              the CD represented by the given toc-file. The retrieved data  is
56              added  as  CD-TEXT data for language 0 to the toc-file. Existing
57              CD-TEXT data for language 0 will be overwritten.
58
59       show-data
60              Print out all samples that would be written to  the  CD-R.  Each
61              line  contains the sample number (starting at 0) and the decimal
62              sample value for the left and right channel. Useful to check  if
63              the byte order of audio files is correct.
64
65       read-test
66              Check  if  all  data  can  be read from the audio files that are
67              defined in the toc-file.  This will also check the communication
68              with the slave process that is responsible for writing the audio
69              data to the CD-recorder. Mainly used for testing.
70
71       disk-info
72              Shows information about the inserted CD-R. If the  CD-R  has  an
73              open  session  it will also print the start of the last and cur‐
74              rent session which is used by mkisofs to create an image  for  a
75              second or higher session.
76
77       msinfo Shows information required for creating multi session disks with
78              mkisofs. The output is meant for processing by scripts.
79
80       unlock Tries to unlock the recorder device after a failed write or sim‐
81              ulation  run.  If you cannot eject the CD after a cdrdao run try
82              this command.
83
84       blank  Blanks a CD-RW. The CD-RW is minimally blanked by  default.  Use
85              option  --blank-mode to select another blanking mode.  Sometimes
86              the blanking speed must be manually  reduced  for  a  successful
87              blanking  operation. Use option --speed to select another blank‐
88              ing speed.
89
90       simulate
91              Like write but laser stays cold. It  is  a  shortcut  for  write
92              --simulate.
93
94       write  Write the CD-R according to the specifications in the toc-file.
95
96       copy   Performs  all  steps  to  copy  a  CD. The device containing the
97              source CD must be specified with option --source-device and  the
98              recorder  device  with option --device.  If only a single device
99              is available the option --source-device must be omitted and cdr‐
100              dao  will prompt to insert the CD-R after an image of the source
101              CD was created.
102
103              The image file with name "cddata<pid>.bin" will  be  created  in
104              the  current working directory if no --datafile option is given.
105              The created image will be removed after it has been written.
106
107              If option --on-the-fly is given no image file is created and the
108              data  will  be  directly piped from the reading device to the CD
109              recorder.
110
111
112

OPTIONS

114       --device [prot:]bus,id,lun
115              Sets the SCSI address of the CD-recorder in form of a bus/id/lun
116              triple,  e.g. '0,2,0' for the logical unit 0 of SCSI device with
117              ID 2 on bus 0. ATAPI devices can be specified by using the  pre‐
118              fix  'ATAPI:', e.g. 'ATAPI:0,0,0'. On some systems a device node
119              may be specified directly, e.g.  '/dev/sg0'  on  Linux  systems.
120              Linux  2.6 users may also try the newer ATAPI interface with the
121              'ATA:' prefix.
122
123       --source-device [prot:]bus,id,lun
124              Like above but used for the copy command to specify  the  source
125              device.
126
127       --driver driver-id:option-flags
128              Force  usage  of  specified  driver instead of the automatically
129              determined driver. Available driver IDs:
130              cdd2600, plextor,  plextor-scan,  generic-mmc,  generic-mmc-raw,
131              ricoh-mp6200,   yamaha-cdr10x,  teac-cdr55,  sony-cdu920,  sony-
132              cdu948, taiyo-yuden, toshiba.
133              Specifying an illegal driver ID will give a  list  of  available
134              drivers.   Option  flags  may  be used to modify the behavior of
135              some drivers. See README for details.
136
137       --source-driver driver-id:option-flags
138              Like above  but  used  for  the  device  specified  with  option
139              --source-device.
140
141       --speed value
142              Set the writing speed to value.  Default is the highest possible
143              speed.
144
145       --blank-mode mode
146              Sets the blanking mode. Available modes are  full  and  minimal.
147              Please  consider that the data of minimally blanked disks may be
148              easily recovered. Use the  full  blanking  mode  for  completely
149              erasing all data. The default blanking mode is minimal.
150
151       --datafile file
152              Used  for read-toc, read-cd and copy.  Set the default data file
153              placed in the toc-file by read-toc.  Use "-" to indicate  STDIN.
154              For  commands read-cd and copy it specifies the name of the cre‐
155              ated image file.
156
157       --read-raw
158              Only used for commands read-cd and read-toc.  All  data  sectors
159              will  be written as 2352 byte blocks including the sector header
160              and L-EC data to the image file. The track mode will be  set  to
161              MODE1_RAW or MODE2_RAW in the created toc-file.
162
163       --read-subchan mode
164              Used by commands read-cd, read-toc and copy.  Specifies the type
165              of sub-channel data that is extracted from  the  source  CD  and
166              written  to  the  track  image  or copied to the destination CD.
167              Mode may be rw for reading  packed  R-W  sub-channel  data  (de-
168              interleaved  and error corrected) and rw_raw for reading raw R-W
169              sub-channel data (not de-interleaved, not error corrected,  L-EC
170              data included in the track image).  If this option is not speci‐
171              fied no sub-channel data will be extracted.
172
173       --no-mode2-mixed
174              Only used  for  commands  read-cd  and  read-toc.   If  we  have
175              MODE2_FORM1  or MODE2_FORM2, don't extract it as MODE2_FORM_MIX.
176              toc-file.
177
178       --tao-source
179              This option indicates to the commands read-toc and read-cd  that
180              the  source  CD was written in TAO mode. It will be assumed that
181              the pre-gap length between all tracks (except between two  audio
182              tracks)  is  the  standard  150  blocks  plus the number of link
183              blocks (usually 2). The number of link blocks can be  controlled
184              with option --tao-source-adjust.
185
186              Use  this option only if read-toc or read-cd give error messages
187              in the transition areas between two  tracks.  If  you  use  this
188              option  with pressed CDs or CDs written in DAO mode you will get
189              wrong results.
190
191       --tao-source-adjust link-blocks
192              Specifies the number of link blocks for tracks  written  in  TAO
193              mode.  This  option has only an effect if option --tao-source is
194              given.
195
196       --fast-toc
197              Only used for command read-toc.  This option suppresses the pre-
198              gap  length  and index mark extraction which speeds up the read-
199              toc process. Standard 2 second pre-gaps (but no  silence!)  will
200              be  placed  into  the toc-file. The resulting CD will sound like
201              the source CD. Only the CD player's display will behave slightly
202              different in the transition area between two tracks.
203
204              This  option  might help, too, if read-toc fails with your drive
205              otherwise.
206
207
208       --buffers buffer-count
209              Specifies the number of buffers that are allocated to avoid buf‐
210              fer  under  runs.   The  minimal  buffer  count  is fixed to 10,
211              default is 32 except on FreeBSD systems, on which default is 20.
212              Each  buffer  holds 1 second of audio data so that dividing buf‐
213              fer-count by the writing speed gives the maximum time for  which
214              reading of audio data may be stalled.
215
216       --multi
217              If this option is given the session will not be closed after the
218              audio data is successfully written. It  is  possible  to  append
219              another session on such disks, e.g. to create a CD-EXTRA.
220
221       --overburn
222              By  default cdrdao will not allow to write more data on a medium
223              than specified by the current  medium.  This  option  allows  to
224              ignore this condition.
225
226       --eject
227              Eject the CD-R after writing or write simulation.
228
229       --swap Swap  the  byte  order  of  all samples that are send to the CD-
230              recorder.
231
232       --session session-nr
233              Used for read-toc and  read-cd  to  specify  the  session  which
234              should be processed on multi session CDs.
235
236       --reload
237              Indicates  that  the  tray  may be opened before writing without
238              prompting the user to reset the disk status after  a  simulation
239              run.
240
241       --force
242              Forces the execution of an operation that otherwise would not be
243              performed.
244
245       --paranoia-mode mode
246              Sets the correction mode for digital  audio  extraction.  0:  No
247              checking,  data  is  copied  directly from the drive. 1: Perform
248              overlapped reading to avoid jitter. 2: Like  1  but  with  addi‐
249              tional  checks  of the read audio data. 3: Like 2 but with addi‐
250              tional scratch detection and repair.
251
252              The extraction speed reduces from 0 to 3.
253
254              Default is the full paranoia mode (3).
255
256       --keepimage
257              If a CD is copied with command copy this option will cause  that
258              the created image is not removed after the copy process has fin‐
259              ished.
260
261       --on-the-fly
262              Perform CD copy on the fly without creating an image file.
263
264       --with-cddb
265              Enables the automatic fetching of CDDB data for use  as  CD-TEXT
266              data for commands copy, read-toc and read-cd.
267
268       --cddb-servers server-list
269              Sets  space  or ',' separated list of CDDB servers used for com‐
270              mand read-cddb or for commands where the --with-cddb  option  is
271              active.  A server entry may have the following forms:
272
273       <server>
274              Connect  to <server>, default cddbp port (888), use cddbp proto‐
275              col.
276
277       <server>:<port>
278              Connect to <server>, port <port>, use cddbp protocol.
279
280       <server>:<cgi-bin-path>
281              Connect to <server>, default http port (80), use http  protocol,
282              url: <cgi-bin-path>.
283
284       <server>:<port>:<cgi-bin-path>
285              Connect  to <server>, port <port>, use http protocol, url: <cgi-
286              bin-path>.
287
288       <server>:<port>:<cgi-bin-path>:<proxy-server>
289              Connect to <proxy-server>, default http port (80), use http pro‐
290              tocol, url: http://<server>:<port>/<cgi-bin-path>.
291
292       <server>:<port>:<cgi-bin-path>:<proxy-server>:<proxy-port>
293              Connect to <proxy-server>, port <proxy-port>, use http protocol,
294              url: http://<server>:<port>/<cgi-bin-path>.
295
296              The <cgi-bin-path> is usually "/~cddb/cddb.cgi".
297
298              All servers of the server list will be tried in the given  order
299              until a successful connection can be established. For http proxy
300              servers the first successful connected http proxy server will be
301              used  independent  of  the ability to connect to the target http
302              server.
303
304              Example: freedb.freedb.org:/~cddb/cddb.cgi
305
306       --cddb-timeout timeout
307              Sets the  timeout  in  seconds  used  for  connections  to  CDDB
308              servers.
309
310       --cddb-directory directory
311              Specifies  the  local CDDB database directory where fetched CDDB
312              records will be stored. If this option is not  given  a  fetched
313              CDDB record will not be stored locally.
314
315       --tmpdir directory
316              Specifies  the  directory in which to store temporary data files
317              created from decoding MP3 and  Ogg  Vorbis  files.  By  default,
318              "/tmp" is used.
319
320       --keep Upon exit from cdrdao, do not delete temporary WAV files created
321              from MP3 and Ogg Vorbis files.
322
323       --save Saves  some  of  the  current  options  to  the  settings   file
324              "$HOME/.cdrdao"  and  exit.  See  section  ´SETTINGS´  for  more
325              details.
326
327       -n     Suppresses the 10 second pause before writing or simulating.
328
329       -v verbose-level
330              Sets verbose level. Levels > 2 are debug levels which produce  a
331              lot of output.
332
333

TOC FILES

335       The toc-file describes what data is written to the CD-R and allows con‐
336       trol over track/index positions, pre-gaps and sub-channel  information.
337       It is a simple text file, use your favorite text editor to create it.
338
339       A toc-file contains an optional header and a sequence of track specifi‐
340       cations. Comments starting with '//' reaching until end of line can  be
341       placed anywhere.
342
343
344   Header
345       CATALOG "ddddddddddddd"
346              Specifies the optional catalog number of the CD. The string must
347              contain exactly 13 digits.
348
349       The following flags specify the type of session that will  be  created.
350       It is used to create the correct CD-TOC format and to check the consis‐
351       tency of the track modes for the  desired  session  type.  If  multiple
352       flags are given the last one will take effect.
353
354       CD_DA  The disc contains only audio tracks.
355
356       CD_ROM The  disc contains just mode 1 tracks or mode 1 and audio tracks
357              (mixed mode CD).
358
359       CD_ROM_XA
360              The disc contains mode 2 form 1 or mode 2 form 2  tracks.  Audio
361              tracks are allowed, too. This type must be used if multi session
362              disks are created (option --multi).
363
364       CD_TEXT { ... }
365              Defines global CD-TEXT data like the album title  and  the  used
366              languages.   See the CD-TEXT section below for the syntax of the
367              CD-TEXT block contents.
368
369   Track Specification
370       TRACK <track-mode> [<sub-channel-mode>]
371              Starts a new track, the track number is incremented  by  1.  The
372              length  of  a track must be at least 4 seconds. The block length
373              of the input data depends on the <track-mode>: AUDIO: 2352 bytes
374              (588  samples), MODE1: 2048 bytes, MODE1_RAW: 2352 bytes, MODE2:
375              2336 bytes, MODE2_FORM1: 2048 bytes,  MODE2_FORM2:  2324  bytes,
376              MODE2_FORM_MIX:  2336 bytes including the sub-header, MODE2_RAW:
377              2352 bytes.  The <sub-channel-mode> is  optional.  If  given  it
378              specifies  the  type  of  sub-channel  data for each sector. RW:
379              packed R-W sub-channel data (96 bytes, L-EC data will be  gener‐
380              ated if required), RW_RAW: raw R-W sub-channel data (interleaved
381              and L-EC data already calculated, 96 bytes). The block length is
382              increased by the sub-channel data length if a <sub-channel-mode>
383              is specified.  If the input data length is not a multiple of the
384              block length  it will be padded with zeros.
385
386       The following flags may follow the track start statement. They are used
387       to set sub-channel information for the  current  track.  Each  flag  is
388       optional.  If  not given the following defaults are used: copy not per‐
389       mitted, no pre emphasis, two channel audio, no ISRC code.
390
391       [ NO ] COPY
392              Sets or clears the copy permitted flag.
393
394       [ NO ] PRE_EMPHASIS
395              Sets or clears the pre emphasis flag (only for audio tracks).
396
397       TWO_CHANNEL_AUDIO
398              Indicates that track contains two channel audio data  (only  for
399              audio tracks).
400
401       FOUR_CHANNEL_AUDIO
402              Indicates  that track contains four channel audio data (only for
403              audio tracks).
404
405       ISRC "CCOOOYYSSSSS"
406              Sets ISRC code of track (only for audio tracks).
407              C: country code (upper case letters or digits)
408              O: owner code (upper case letters or digits)
409              Y: year (digits)
410              S: serial number (digits)
411
412       An optional CD-TEXT block that defines the CD-TEXT data for this  track
413       may follow. See the CD-TEXT section below for the syntax of the CD-TEXT
414       block contents.
415
416       CD_TEXT { ... }
417
418       At least one of the following statements must  appear  to  specify  the
419       data  for  the  current  track.  Lengths  and  start  positions  may be
420       expressed in samples (1/44100 seconds) for audio tracks or in bytes for
421       data  tracks. It is also possible to give the length in blocks with the
422       MSF format 'MM:SS:FF' specifying minutes, seconds and frames (0 <= 'FF'
423       < 75) . A frame equals one block.
424
425       If  more  than one statement is used the track will be composed by con‐
426       catenating the data in the specified order.
427
428       SILENCE <length>
429              Adds zero audio data of specified length to  the  current  audio
430              track.  Useful to create silent pre-gaps.
431
432       ZERO <length>
433              Adds  zero  data  to data tracks. Must be used to define pre- or
434              post-gaps between tracks of different mode.
435
436       [ FILE | AUDIOFILE ] "<filename>" <start> [ <length> ]
437              Adds the audio data of  specified  file  to  the  current  audio
438              track.  It is possible to select a portion of an audio file with
439              <start> and <length> which allows non destructive  cutting.  The
440              first  sample of an audio file is addressed with <start> = 0. If
441              <length> is omitted or set to 0  all  audio  data  from  <start>
442              until the end of file is used.
443
444              Audio files may have raw or WAVE format with 16 bits per sample,
445              44.1 kHz sampling rate, stereo. Raw files must have  the  layout
446              'MSBLeft LSBLeft MSBRight LSBRight ...' (big endian byte order).
447              WAVE files are expected to have little endian  byte  order.  The
448              option  --swap  reverses the expected byte order for all raw and
449              WAVE files. Only filenames with a ".wav" ending are  treated  as
450              WAVE  files,  all other names are assumed to be raw audio files.
451              Use tools like sox(1) to convert other file formats to supported
452              formats.
453
454              Specifying  a "-" as filename causes data to be read from STDIN.
455              Currently only raw files are supported from STDIN.
456
457              If you are unsure about the byte order of your audio  files  try
458              the  command  'show-data'. If the byte order is correct you will
459              see a sequence of increasing  or  decreasing  numbers  for  both
460              channels.  Otherwise  numbers  are jumping between very high and
461              low values - high volume static.
462
463       DATAFILE "<filename>" [ <length> ]
464              Adds data from given file to the current data track. If <length>
465              is omitted the actual file length will be used.
466
467       FIFO "<fifo path>" <length>
468              Adds  data from specified FIFO path to the current audio or data
469              track.  <length> must specify the amount of data  that  will  be
470              read  from  the  FIFO.  The  value  is  always in terms of bytes
471              (scalar value) or in terms of the block length (MSF value).
472
473       START [ MM:SS:FF ]
474              Defines the length of the pre-gap (position where index switches
475              from  0  to  1).  If  the MSF value is omitted the current track
476              length is used. If the current track length is not a multiple of
477              the  block  length the pre-gap length will be rounded up to next
478              block boundary.
479
480              If no START statement is given the track will not  have  a  pre-
481              gap.
482
483       PREGAP MM:SS:FF
484              This  is  an  alternate way to specify a pre-gap with zero audio
485              data. It may appear before  the  first  SILENCE,  ZERO  or  FILE
486              statement.  Either  PREGAP  or  START can be used within a track
487              specification. It is equivalent to the sequence
488                SILENCE MM:SS:FF
489                START
490              for audio tracks or
491                ZERO MM:SS:FF
492                START
493              for data tracks.
494
495       Nothing prevents  mixing  'DATAFILE'/'ZERO'  and  'AUDIOFILE'/'SILENCE'
496       statements within the same track. The results, however, are undefined.
497
498
499       The  end of a track specification may contain zero or more index incre‐
500       ment statements:
501
502       INDEX MM:SS:FF
503              Increments the index number at given position within the  track.
504              The  first statement will increment from 1 to 2. The position is
505              relative to the real track start, not counting an existing  pre-
506              gap.
507
508
509   CD-TEXT Blocks
510       A  CD-TEXT  block  may  be  placed in the global section to define data
511       valid for the whole CD and in each track specification of  a  toc-file.
512       The  global  section  must  define a language map that is used to map a
513       language-number to country codes. Up to 8 different  languages  can  be
514       defined:
515
516       LANGUAGE_MAP { 0 : c1  1 : c2  ...  7 : c7 }
517              The  country code may be an integer value in the range 0..255 or
518              one of the following countries (the corresponding integer  value
519              is placed in braces behind the token): EN(9, English)
520              It is just necessary to define a mapping for the used languages.
521
522       If  no  mapping exists for a language-number the data for this language
523       will be ignored.
524
525       For each language a language block must exist that defines  the  actual
526       data for a certain language.
527
528       LANGUAGE  language-number  { cd-text-item cd-text-data cd-text-item cd-
529       text-data ... }
530              Defines the CD-TEXT items for given language-number  which  must
531              be defined in the language map.
532
533       The  cd-text-data  may  be either a string enclosed by " or binary data
534       like
535            { 0, 10, 255, ... }
536       where each integer number must be in the range 0..255.
537       The cd-text-item may be one of the following:
538
539       TITLE  String data: Title of CD or track.
540
541       PERFORMER
542              String data.
543
544       SONGWRITER
545              String data.
546
547       COMPOSER
548              String data.
549
550       ARRANGER
551              String data.
552
553       MESSAGE
554              String data. Message to the user.
555
556       DISC_ID
557              String data: Should only appear in the global CD-TEXT block. The
558              format is usually: XY12345
559
560       GENRE  Mixture of binary data (genre code) and string data. Should only
561              appear in the global CD-TEXT block. Useful entries will be  cre‐
562              ated by gcdmaster.
563
564       TOC_INFO1
565              Binary data: Optional table of contents 1. Should only appear in
566              the global CD-TEXT block.
567
568       TOC_INFO2
569              Binary data: Optional table of contents 2. Should only appear in
570              the global CD-TEXT block.
571
572       UPC_EAN
573              String  data: This item should only appear in the global CD-TEXT
574              block. Was always an empty string  on  the  CD-TEXT  CDs  I  had
575              access to.
576
577       ISRC   String  data: ISRC code of track. The format is usually: CC-OOO-
578              YY-SSSSS
579
580       SIZE_INFO
581              Binary data: Contains summary about all CD-TEXT data and  should
582              only  appear in the global CD-TEXT block. The data will be auto‐
583              matically (re)created when the CD-TEXT data is written.
584
585              If one of the CD-TEXT items TITLE, PERFORMER,  SONGWRITER,  COM‐
586              POSER, ARRANGER, ISRC is defined for at least on track or in the
587              global section it must be defined for  all  tracks  and  in  the
588              global  section. If a DISC_ID item is defined in the global sec‐
589              tion, an ISRC entry must be defined for each track.
590
591
592   Examples
593       Simple track without  pre-gap  with  all  audio  data  from  WAVE  file
594       "data.wav":
595            CD_DA
596            TRACK AUDIO
597            FILE "data.wav" 0
598
599       Standard track with two second pre-gap, ISRC code and CD-TEXT:
600            CD_DA
601            CD_TEXT {
602              LANGUAGE_MAP {
603                0 : EN
604              }
605
606              LANGUAGE 0 {
607                TITLE "CD Title"
608                PERFORMER "Performer"
609                DISC_ID "XY12345"
610                UPC_EAN ""
611              }
612            }
613
614            TRACK AUDIO
615            ISRC "DEXXX9800001"
616            CD_TEXT {
617              LANGUAGE 0 {
618                TITLE "Track Title"
619                PERFORMER "Performer"
620                ISRC "DE-XXX-98-00001"
621              }
622            }
623            PREGAP 0:2:0
624            FILE "data.wav" 0
625
626       Track  with  10  second  pre-gap  containing  audio  data from raw file
627       "data.cdr":
628            CD_DA
629            TRACK AUDIO
630            FILE "data.cdr" 0
631            START 0:10:0
632
633       Composed track with data from different files. Pre-gap data and  length
634       is  taken  from  "pregapdata.wav".  The  first minute of "track.cdr" is
635       omitted and two seconds silence are inserted at '2:0:0'. Index will  be
636       incremented after 2 and 4 minutes past track start:
637            CD_DA
638            TRACK AUDIO
639            FILE "pregapdata.wav" 0
640            START
641            FILE "track.cdr" 1:0:0 1:0:0
642            SILENCE 0:2:0
643            FILE "track.cdr" 2:0:0
644            INDEX 2:0:0
645            INDEX 4:0:0
646
647       Mixed  mode  CD  with a data track as first track followed by two audio
648       tracks.
649            CD_ROM
650            TRACK MODE1
651            DATAFILE "data_1"
652            ZERO 00:02:00 // post-gap
653
654            TRACK AUDIO
655            SILENCE 00:02:00 // pre-gap
656            START
657            FILE "data_2.wav" 0
658
659            TRACK AUDIO
660            FILE "data_3.wav" 0
661
662

CUE FILES

664       Cue files may be used wherever a toc-file is expected. The  correspond‐
665       ing  bin  file  is  not taken from the FILE statement of a cue file but
666       constructed from the cue file name by replacing ".cue" by  ".bin".  The
667       cue file must have exactly one FILE statement.
668
669       Currently, following track modes are supported: MODE1/2048, MODE1/2352,
670       MODE2/2336, MODE2/2352. The CATALOG, ISRC and  POSTGAP  statements  are
671       parsed but not evaluated, yet.
672
673

SETTINGS

675       Some of the command line options can be stored as settings at following
676       locations. The files will be read on startup of cdrdao in that order:
677
678       1. /etc/cdrdao.conf
679
680       2. /etc/defaults/cdrdao
681
682       3. /etc/default/cdrdao
683
684       4. $HOME/.cdrdao
685
686
687       Command line options will overwrite the loaded settings.  The  settings
688       file  contains  name  - value pairs separated by a colon. String values
689       must be enclosed by ". The file is automatically written if the command
690       line  option  --save is used but it is also possible to modify it manu‐
691       ally. Following values are defined:
692
693       write_device
694              Device used for operations simulate, write, copy,  blank,  disk-
695              info and unlock.  Corresponding option: --device
696
697       write_driver
698              Driver  (including  driver  options) that is used for operations
699              simulate, write, copy, blank, disk-info and unlock.  Correspond‐
700              ing option: --driver
701
702       write_speed
703              Specifies writing speed. Corresponding option: --speed
704
705       write_buffers
706              Specifies fifo buffers used for recording. Corresponding option:
707              --buffers
708
709       read_device
710              Device used for operations read-toc, read-cd and  copy.   Corre‐
711              sponding option: --device or --source-device
712
713       read_driver
714              Driver  (including driver options) used for operations read-toc,
715              read-cd and copy.  Corresponding option: --driver  or  --source-
716              driver
717
718       read_paranoia_mode
719              Paranoia mode used for operations read-cd and copy.  Correspond‐
720              ing option: --paranoia-mode
721
722       cddb_server_list
723              CDDB server list for read-cddb.  Corresponding  option:  --cddb-
724              servers
725
726       cddb_timeout
727              CDDB  connection  timeout  in seconds used by read-cddb.  Corre‐
728              sponding option: --cddb-timeout
729
730       cddb_directory
731              Local directory where fetched CDDB records will be stored,  used
732              by read-cddb.  Corresponding option: --cddb-directory
733
734       tmp_file_dir
735              Directory  where temporary WAV files will be created from decod‐
736              ing MP3 and Ogg Vorbis files. Corresponding option: --tmpdir
737

BUGS

739       If the program is terminated during the write/simulation  process  used
740       IPC  resources  may not be released. Use ipcs(8) and ipcrm(8) to delete
741       them.
742

AUTHOR

744       Andreas Mueller mueller@daneb.ping.de [DEFUNCT]
745       Denis Leroy <denis@poolshark.org>
746       Manuel Clos <llanero@users.sourceforge.net>
747

SEE ALSO

749       gcdmaster(1), cdrecord(1), cdda2wav(1), cdparanoia(1), sox(1), ipcs(8),
750       ipcrm(8)
751
752
753
754                                 Jan 18, 2006                        CDRDAO(1)
Impressum