NAME
    cdda2wav  - a sampling utility that dumps CD audio data into wav sound
    files

SYNOPSIS
    cdda2wav [-c chans] [-s] [-m] [-b bits] [-r rate] [-a  divider] [-t
    track[+endtrack]] [-i index] [-o offset] [-d duration] [-x] [-q] [-w]
    [-v optlist] [-V] [-Q] [-J] [-L cddbmode] [-R] [-P sectors] [-F] [-G]
    [-T] [-e] [-p percentage] [-n sectors] [-l buffers] [-N] [-J] [-H] [-g]
    [-B] [-D device] [-A auxdevice]  [-I interface] [-O audiotype] [-C
    input-endianess]  [-E output-endianess]  [-M count] [-S speed] [-para-
    noia] [cddbp-server=servername] [cddbp-port=portnumber] [filename(s) or
    directories]

DESCRIPTION
    cdda2wav  can retrieve audio tracks from CDROM drives (see README for a
    list of drives) that are capable of reading audio data digitally to the
    host (CDDA).

OPTIONS
    -D device --dev --device
    uses device as the source for CDDA reading.  For example
    /dev/cdrom for the cooked_ioctl interface and Bus,ID,Lun for the
    generic_scsi interface. The device has to correspond with the
    interface setting (see below). The setting of the environment
    variable CDDA_DEVICE is overridden by this option.

    -A auxdevice --auxdevice
    uses auxdevice as CDROM drive for ioctl usage.

    -I interface --interface
    specifies  the interface  for CDROM access: generic_scsi or (on
    Linux, and FreeBSD systems) cooked_ioctl.

    -c channels --channels
    uses 1 for mono, or 2 for stereo recording, or s for stereo
    recording with both channels swapped.

    -s --stereo
    sets to stereo recording.

    -m --mono
    sets to mono recording.

    -x --max
    sets maximum (CD) quality.

    -b bits --bits-per-sample
    sets bits per sample per channel: 8, 12 or 16.

    -r rate --rate
    sets rate in samples per second. Possible values are listed
    with the -R option.

    -a divider --divider
    sets rate to 44100Hz / divider. Possible values are listed with
    the -R option.

    -R --dump-rates
    shows a list of all sample rates and their dividers.

    -P sectors --set-overlap
    sets the  initial number of overlap sectors for jitter correc-
    tion.

    -n sectors --sectors-per-request
    reads sectors per request.

    -l buffers --buffers-in-ring
    uses a ring buffer with buffers total.

    -t track+endtrack --track
    selects the start track and optionally the end track.

    -i index  --index
    selects the start index.

    -o offset --offset
    starts offset sectors behind start track (one sector equivalents
    1/75 seconds).

    -O audiotype --output-format
    can be wav (for wav files) or aiff (for apple/sgi aiff files) or
    aifc (for apple/sgi aifc files) or au or sun (for  sun .au PCM
    files) or cdr or raw (for headerless files to be used for cd
    writers).

    -C endianess --cdrom-endianess
    sets endianess of  the input samples to 'little', 'big' or
    'guess' to override defaults.

    -E endianess --output-endianess
    sets endianess of the output samples to 'little' or 'big' to
    override defaults.

    -d duration --duration
    sets recording time in seconds or frames.  Frames (sectors) are
    indicated by a 'f' suffix (like 75f for 75 sectors). 0 sets the
    time for whole track.

    -B --bulk --alltracks
    copies each track into a seperate file.

    -w --wait
    waits for signal, then start recording.

    -F --find-extremes
    finds extrem amplitudes in samples.

    -G --find-mono
    finds if input samples are in mono.

    -T --deemphasize
    undo the effect of pre-emphasis in the input samples.

    -e --echo
    copies audio data to sound device e.g. /dev/dsp.

    -p percentage --set-pitch
    changes pitch of audio data copied to sound device.

    -v itemlist --verbose-level
    prints verbose information about the CD. Level is a list of
    comma seperated suboptions. Each suboption controls the type of
    information to be reported.

 +----------+----------------------------------------------------------------+
 |Suboption | Description        |
 +----------+----------------------------------------------------------------+
 | disable | no information is given, warnings appear however    |
 |   all | all information is given       |
 |   toc | show table of contents       |
 | summary | show a summary of the recording parameters     |
 | indices | determine and display index offsets     |
 | catalog | retrieve and display the media catalog number MCN    |
 | trackid | retrieve and display all Intern. Standard Recording Codes ISRC |
 | sectors | show the table of contents in start sector notation   |
 |  titles | show the table of contents with track titles (when available) |
 +----------+----------------------------------------------------------------+
    -N --no-write
    does not write to a file, it just reads  (for debugging pur-
    poses).

    -J --info-only
    does not  write to a file, it just gives information about the
    disc.

    -L cddb mode --cddb
    does a cddbp album- and track title lookup based on the cddb id.
    The parameter cddb mode defines how multiple entries shall be
    handled.

 cddbp-server=servername
    sets the server to be contacted for title lookups.

 cddbp-port=portnumber
    sets the port number to be used for title lookups.

    -H --no-infofile
    does not write an info file and a cddb file.

    -g --gui
    formats the output to be better parsable by gui frontends.

    -M count --md5
    enables calculation of MD-5 checksum for 'count' bytes from a
    beginning of a track.

    -S speed --speed
    sets the cdrom device to one of the selectable speeds for read-
    ing.

    -q --quiet
    quiet operation, no screen output.

    -V --verbose-SCSI
    enable SCSI command logging to the console. This is mainly used
    for debugging.

    -Q --silent-SCSI
    suppress SCSI command error reports to the console. This is
    mainly used for guis.

    -paranoia
    use the paranoia library instead  of cdda2wav's  routines for
    reading.

    -h --help
    display version of cdda2wav on standard output.

    Defaults depend on the
    Makefile  and environment  variable  settings  (currently
    CDDA_DEVICE ).

ENVIRONMENT VARIABLES
    CDDA_DEVICE is used to set the device name. The device naming is com-
    patible with J