MAN page from Old RedHat 5.X cdrdao-1.1.0-1.i386.rpm

CDRDAO

Section: User Commands (1)
Updated: Mar 07, 1999
Index

NAME

cdrdao - writes audio CD-Rs in disc-at-once mode

SYNOPSIS

DESCRIPTION

cdrdaocreates audio CD-Rs in disk-at-once (DAO) mode driven by a descriptionfile calledtoc-file.In DAO mode it is possible to create non standard track pre-gaps thathave other lengths than 2 seconds and contain nonzero audiodata. This is for example useful to divide live recordings intotracks where 2 second gaps would be kind of irritating.

This tool can only produce audio CDs, it is not possible to createdata tracks.

COMMANDS

The first argument must be one of the following commands:
show-toc: Print out a summary about what will be written to the CD-R.
read-toc: Analyze each track of the inserted audio CD and create atoc-filethat can be used to make a more or less exact copy of the CD. This command does not read out the audio data itself,use specialized programs like cdda2wav(1) or cdparanoia(1) for this purpose.
You can specify a filename for the data file (holding the audio data frome.g. cdda2wav(1)) via the--datafileoption.
show-data: Print out all samples that would be written to the CD-R. Each linecontains the sample number (starting at 0) and the decimal samplevalue for the left and right channel. Useful to check if the byteorder of audio files is correct.
read-test: Check if all data can be read from the audio files that are defined inthetoc-file.This will also check the communication with the slave process that isresponsible for writing the audio data to the CD-recorder. Mainly usedfor testing.
disk-info: Shows information about the inserted CD-R.
simulate: Likewritebut laser stays cold.
write: Write the CD-R according to the specifications in thetoc-file.

OPTIONS

--device bus,id,lun: Sets the SCSI address of the CD-recorder in form of a bus/id/luntriple, e.g. '0,2,0' for the logical unit 0 of SCSI device with ID 2on bus 0. On some systems a device node may be specified directly,e.g. '/dev/sg0' on Linux systems.
--driver driver-id: Force usage of specified driver instead of the automaticallydetermined driver. Available driver IDs:
cdd2600, plextor, plextor-scan, generic-mmc, generic-mmc-raw,ricoh-mp6200, yamaha-cdr10x
Specifying an illegal driver ID will give a list of available drivers.
--speed value: Set the writing speed tovalue.Default is the highest possible speed.
--datafile file: Only used forread-toc.Set the default data file in the toc-file. Use "-" for STDIN. Default valueis "data.wav".
--buffers buffer-count: Specifies the number of buffers that are allocated to avoid buffer under runs.The minimal buffer count is fixed to 10, default is 32.Each buffer holds 1 second of audio data so that dividingbuffer_countby the writing speed gives the maximum time for which reading of audio datamay be stalled.
--multi: If this option is given the session will not be closed after the audio datais successfully written. It is possible to append another session on suchdisks, e.g. to create a CD-EXTRA.
--eject: Eject the CD-R after writing or write simulation.
--swap: Swap the byte order of all samples that are send to the CD-recorder.

TOC FILES

Thetoc-filedescribes what audio data is written to the CD-R and allows controlover track/index positions, pre-gaps and sub-channel information. Itis a simple text file, use your favorite text editor to create it.

Atoc-filecontains an optional header and a sequence of trackspecifications. Comments starting with '//' reaching until end of line can beplaced anywhere.

Header

CATALOG ddddddddddddd: Specifies the optional catalog number of the CD. The string mustcontain exactly 13 digits.

The following flags specify the type of session that will be created. Itis used to create the correct CD-TOC format and to check the consistency ofthe track modes for the desired session type. If multiple flags are giventhe last one will take effect.

CD_DA: The disc contains only audio tracks.
CD_ROM: The disc contains just mode 1 tracks or mode 1 and audio tracks (mixedmode CD).
CD_ROM_XA: The disc contains mode 2 form 1 or mode 2 form 2 tracks. Audio tracksare allowed, too. This type must be used if multi session disks arecreated (option --multi).

Track Specification

TRACK [ AUDIO | MODE1 | MODE2 | MODE2_FORM1 | MODE2_FORM2 ]: Starts a new track, the track number is incremented by 1. The lengthof a track must be at least 4 seconds. The block length of the inputdata depends on the track mode: AUDIO: 2352 bytes (588 samples),MODE1: 2048 bytes, MODE2: 2336 bytes, MODE2_FORM1: 2048 bytes,MODE2_FORM2: 2324 bytes.If the input data length is not a multiple of the block length itwill be padded with zeros.

The following flags may follow the track start statement. They areused to set sub-channel information for the current track. Each flagis optional. If not given the following defaults are used: copypermitted, no pre emphasis, two channel audio, no ISRC code.

[ NO ] COPY: Sets or clears the copy permitted flag.
[ NO ] PRE_EMPHASIS: Sets or clears the pre emphasis flag (only for audio tracks).
TWO_CHANNEL_AUDIO: Indicates that track contains two channel audio data (only for audio tracks).
FOUR_CHANNEL_AUDIO: Indicates that track contains four channel audio data (only for audio tracks).
ISRC CCOOOYYSSSSS: Sets ISRC code of track (only for audio tracks).
C: country code (upper case letters or digits)
O: owner code (upper case letters or digits)
Y: year (digits)
S: serial number (digits)

At least one of the following statements must appear to specify thedata for the actual track. Lengths and start positions may beexpressed in samples (1/44100 seconds) for audio tracks or in bytesfor data tracks. It is also possible to give the length in blockswith the MSF format 'MM:SS:FF' specifying minutes, seconds and frames(0 <= 'FF' < 75) . A frame equals one block.

If more than one statement is used the track will be composed byconcatenating the data in the specified order.

SILENCE <length>

Adds zero audio data of specified length to actual audio track. Useful to create silent pre-gaps.

ZERO <length>

Adds zero data to data tracks. Must be used todefine pre- or post-gaps between tracks of different mode.

[ FILE | AUDIOFILE ] <filename> <start> [ <length> ]

Adds the audio data of specified file to actual audio track. It is possibleto select a portion of an audio file with <start> and <length>which allows non destructive cutting. The first sample of an audio file isaddressed with <start> = 0. If <length> is omitted or set to 0 allaudio data from <start> until the end of file is used.

Audio files may have raw or WAVE format with 16 bits per sample, 44.1kHz sampling rate, stereo. Raw files must have the layout 'MSBLeftLSBLeft MSBRight LSBRight ...' (big endian byte order). WAVE files areexpected to have little endian byte order. The option --swap reversesthe expected byte order for all raw and WAVE files. Only filenameswith a ".wav" ending are treated as WAVE files, all other names areassumed to be raw audio files. Use tools like sox(1) to convert otherfile formats to supported formats.

Specifying a "-" as filename causes data to be read from STDIN. Currentlyonly raw files are supported from STDIN.
If you are unsure about the byte order of your audio files try thecommand 'show-data'. If the byte order is correct you will see asequence of increasing or decreasing numbers for bothchannels. Otherwise numbers are jumping between very high and lowvalues - high volume static.

DATAFILE <filename> [ <length> ]

Adds data from given file to actual data track. If <length> is omittedthe actual file length will be used.

START [ MM:SS:FF ]

Defines the length of the pre-gap (position where index switches from0 to 1). If the MSF value is omitted the current track length isused. If the current track length is not a multiple of the blocklength the pre-gap length will be rounded up to next block boundary.

If no START statement is given the track will not have a pre-gap.

PREGAP MM:SS:FF

This is an alternate way to specify a pre-gap with zero audio data. Itmay appear before the first SILENCE, ZERO or FILE statement. Either PREGAPor START can be used within a track specification. It is equivalent tothe sequence

  SILENCE MM:SS:FF

  START
for audio tracks or

  ZERO MM:SS:FF

  START
for data tracks.

Nothing prevents mixing 'DATAFILE'/'ZERO' and 'AUDIOFILE'/'SILENCE'statements within the same track. The results, however, are undefined.
The end of a track specification may contain zero or more indexincrement statements:

INDEX MM:SS:FF: Increments the index number at given position within the track. Thefirst statement will increment from 1 to 2. The position is relativeto the real track start, not counting an existing pre-gap.

Examples

Simple track without pre-gap with all audio data from WAVE file"data.wav":

CD_DATRACK AUDIOFILE "data.wav" 0

Standard track with two second pre-gap and ISRC code:

CD_DATRACK AUDIOISRC "DEXXX9800001"PREGAP 0:2:0FILE "data.wav" 0

Track with 10 second pre-gap containing audio data from raw file"data.cdr":

CD_DATRACK AUDIOFILE "data.cdr" 0 START 0:10:0

Composed track with data from different files. Pre-gap data and lengthis taken from "pregapdata.wav". The first minute of"track.cdr" is omitted and two seconds silence are inserted at'2:0:0'. Index will be incremented after 2 and 4 minutes past track start:

CD_DATRACK AUDIOFILE "pregapdata.wav" 0 STARTFILE "track.cdr" 1:0:0 1:0:0SILENCE 0:2:0FILE "track.cdr" 2:0:0INDEX 2:0:0INDEX 4:0:0

Mixed mode CD with a data track as first track followed by two audio tracks.

CD_ROMTRACK MODE1DATAFILE "data_1"ZERO 00:02:00 // post-gapTRACK AUDIOSILENCE 00:02:00 // pre-gapSTARTFILE "data_2.wav" 0 TRACK AUDIOFILE "data_3.wav" 0

BUGS

Error conditions are not handled very gracefully. If the programis terminated during the write/simulation process used IPCresources will not be released. Use ipcs(8) and ipcrm(8) to delete them.

AUTHOR

Andreas Mueller muellerAATTdaneb.ping.de

BUGS

AUTHOR

SEE ALSO

This document was created byman2html,using the manual pages.