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|toc-info|toc-size|read-toc|read-cd|read-cddb|show-
10       data|read-test|disk-info|discid|msinfo|drive-info|unlock|scanbus|simu‐
11       late|write|copy|blank}   [--device   device]  [--source-device  device]
12       [--driver driver-id] [--source-driver driver-id] [--simulate]  [--speed
13       writing-speed]   [--blank-mode  mode]  [--datafile  file]  [--read-raw]
14       [--read-subchan [--no-mode2-mixed] mode] [--tao-source]  [--tao-source-
15       adjust  link-blocks]  [--fast-toc]  [--buffers  buffer-count] [--multi]
16       [--overburn]  [--eject]  [--swap]  [--session]   [--force]   [--reload]
17       [--keepimage]   [--on-the-fly]   [--paranoia-mode  mode]  [--with-cddb]
18       [--cddb-servers server-list] [--cddb-timeout timeout] [--cddb-directory
19       directory]  [--tmpdir  directory]  [--keep]  [--save] [-n] [-v verbose-
20       level] toc-file
21

DESCRIPTION

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

COMMANDS

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

OPTIONS

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

TOC FILES

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

CUE FILES

679       Cue  files may be used wherever a toc-file is expected. The correspond‐
680       ing bin file is not taken from the FILE statement of  a  cue  file  but
681       constructed  from  the cue file name by replacing ".cue" by ".bin". The
682       cue file must have exactly one FILE statement.
683
684       Currently, following track modes are supported: MODE1/2048, MODE1/2352,
685       MODE2/2336,  MODE2/2352.  The  CATALOG, ISRC and POSTGAP statements are
686       parsed but not evaluated, yet.
687
688

SETTINGS

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

BUGS

754       If  the  program is terminated during the write/simulation process used
755       IPC resources may not be released. Use ipcs(8) and ipcrm(8)  to  delete
756       them.
757

AUTHOR

759       Andreas Mueller mueller@daneb.ping.de [DEFUNCT]
760       Denis Leroy <denis@poolshark.org>
761       Manuel Clos <llanero@users.sourceforge.net>
762

SEE ALSO

764       gcdmaster(1), cdrecord(1), cdda2wav(1), cdparanoia(1), sox(1), ipcs(8),
765       ipcrm(8)
766
767
768
769                                 Jan 18, 2006                        CDRDAO(1)
Impressum