Readme File for read_cdda:

Basically it read on audio track from the CD and stores it in the
named file.  It only works under Solaris 2.4 and higher (older
versions don't support CDDA) and it only works with CD-ROM's that
support CDDA which according to the workman docs are:
 
     * SunCD Plus (really a Toshiba 3401)
     * Sun SPARCstation internal drive (really a Toshiba 4101)
     * Toshiba 3401
     * Toshiba 3501
     * Toshiba 4101
 
I've only tested it on the Sun SPARCstation internal drive.  The
program has an option (-d) which will print out what type of drive you
have.  You also need to have access to the CDROM device.  If volume
management is running you should stop it. (as root: 
/etc/init.d/volmgt stop)
 
By default it outputs in CDR format - suitable for writing to a CD
Recorder to create your own CD. (I've made a number of mixed CD's)
Again I've only tested this by writing CD's on a Phillips CDD 522
attached to a linux box - but, in theory, it shouldn't matter :^)
It can also output in Sun .au format (both 8bit mono and 16bit stereo)
which is useful for testing without having to write a CD.
 
The program also has options to specify the starting and ending second
to record. (useful for cutting out the 10 minute "blanks" at the end
of songs that some groups like to add)
 
Let me know of any problems you have.  Like I said, it's not real well
tested by it does work for me.  One final note:  I know the packaging
is a bit excessive for a relatively small program, but believe it or
not, its easier for me as I just have a script that sets it up.


RUNNING THE PROGRAM:

Basic help:

% read_cdda -h
read_cdda: Read audio track from CD to a file
Usage: read_cdda -hasdf <-s {start}> <-e {end}> {file} {track}
 {file}          File name for output
 {track}         Track number to read
 -s  --start     Starting second for the track
 -e  --end       Ending second for the track
 -t  --toc       Only print out the Table of Contents
 -x  --swap      Swap bytes (for x86?)
 -8  --au8       Output in Sun .au format 8KHz
 -a  --au16      Output in Sun .au format 44.1KHz
 -q  --quiet     Be quiet while running
 -d  --drvtype   Print CD-ROM model type only
 -v  --version   Print program version number only

 Default is to output in CDR format the whole track

Normal use:

% read_cdda stones.cdr 4

Read a portion: (from 10sec in until 5:05)

% read_cdda -s 10 -e 305 stones.cdr 4


NOTES:

- The CDROM devices is hard-coded into the program as /dev/rdsk/c0t6d0s2
- You must have read access to the CDROM device
- Volume management must not be running on the CDROM
- I'm not really sure what would happen if writing to the disk fell behind
  the CDROM, but since CDROM's are 150k/s this shouldn't be a problem.
- This probably won't work under Solaris for x86, but there is an options
  to swap the bytes which might enable it to work
- Anyone know how to read at double speed?

CREDITS:

This program was written by Jim Mintha (mintha@geog.ubc.ca) and is
covered by the GNU Public License. (See the file LICENSE in this
directory)

Much of this work was derived from the Workman sources written by
Steven Grimm (koreth@hyperion.com), and he deserves much credit for 
figuring out how Sun's CDDA works, not to mention writing the great 
program Workman.
