icedax(1)


NAME

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

SYNOPSIS

   icedax [-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]
   [-paranoia]      [cddbp-server=servername]      [cddbp-port=portnumber]
   [filename(s) or directories]

DESCRIPTION

   icedax  stands  for InCrEdible Digital Audio eXtractor. It can retrieve
   audio tracks (CDDA) from CDROM drives that are capable of reading audio
   data digitally to the host (see README for a list of drives).

OPTIONS

   dev=device

   -D device

   -device device
          uses  device  as  the  source  for  CDDA  reading.  For  example
          /dev/cdrom or Bus,ID,Lun.  The  device  specification  can  also
          have  influence on the selection of the driver interface (eg. on
          Linux).  See the -I option for details.

          The  setting  of  the  environment   variable   CDDA_DEVICE   is
          overridden by this option.

   -A auxdevice

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

   -I interface

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

          Using the cooked_ioctl is not recommended as this  makes  icedax
          mainly  depend  on the audio extraction quality of the operating
          system which is usually extremely bad.

   -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
          correction.

   -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 separate file.

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

   -F  --find-extremes
          finds extreme 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  separated 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 International 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
          purposes).

   -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.

          
          Parameter                Description                
          
                  0  interactive mode. The user selects the   
                     entry to use.                            
          
                  1  first fit mode. The first entry is taken 
                     unconditionally.                         
          
    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
          reading.

   -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.

   -scanbus
          Scan  all  SCSI devices on all SCSI busses and print the inquiry
          strings. This option may be used to find  SCSI  address  of  the
          CD/DVD-Recorder  on a system.  The numbers printed out as labels
          are computed by: bus * 100 + target

   --devices
          Like -scanbus but works in a more  native  way,  respecting  the
          device  name  specification on the current operating system. See
          wodim(1) for details.

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

   -h  --help
          display version of icedax 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
   compatible with the one used by the wodim tool.

   CDDBP_SERVER
          is used for cddbp title lookups when supplied.

   CDDBP_PORT
          is used for cddbp title lookups when supplied.

   RSH    If   the   RSH  environment  variable  is  present,  the  remote
          connection will not be created via rcmd(3) but  by  calling  the
          program pointed to by RSH.  Use e.g.  RSH=/usr/bin/ssh to create
          a secure shell connection.

          Note that this forces icedax to create  a  pipe  to  the  rsh(1)
          program  and  disallows  icedax  to  directly access the network
          socket to the remote server.  This makes it impossible to set up
          performance parameters and slows down the connection compared to
          a root initiated rcmd(3) connection.

   RSCSI  If the RSCSI environment variable is present,  the  remote  SCSI
          server  will  not  be the program /opt/schily/sbin/rscsi but the
          program pointed to by RSCSI.  Note that the remote  SCSI  server
          program name will be ignored if you log in using an account that
          has been created with a remote  SCSI  server  program  as  login
          shell.

RETURN VALUES

   icedax  uses  the  following  exit codes to indicate various degrees of
   success:

   
   Exitcode                         Description                        
   
          0  no errors encountered, successful operation.              
   
          1  usage or syntax error. icedax got inconsistent arguments. 
   
          2  permission (un)set errors. permission changes failed.     
   
          3  read errors on the cdrom/burner device encountered.       
   
          4  write errors while writing one of the output files        
             encountered.                                              
   
          5  errors with soundcard handling (initialization/write).    
   
          6  errors with stat() system call on the read device (cooked 
             ioctl).                                                   
   
          7  pipe communication errors encountered (in forked mode).   
   
          8  signal handler installation errors encountered.           
   
          9  allocation of shared memory failed (in forked mode).      
   
         10  dynamic heap memory allocation failed.                    
   
         11  errors on the audio cd medium encountered.                
   
         12  device open error in ioctl handling detected.             
   
         13  race condition in ioctl interface handling detected.      
   
         14  error in ioctl() operation encountered.                   
   
         15  internal error encountered. Please report back!!!         
   
         16  error in semaphore operation encountered (install /       
             request).                                                 
   
         17  could not get the scsi transfer buffer.                   
   
         18  could not create pipes for process communication (in      
             forked mode).                                             
   

DISCUSSION

   icedax is able to read  parts  of  an  audio  CD  or  multimedia  CDROM
   (containing audio parts) directly digitally. These parts can be written
   to a file, a pipe, or to a sound device.

   icedax stands for CDDA to WAV  (where  CDDA  stands  for  compact  disc
   digital  audio  and  WAV  is  a  sound  sample  format introduced by MS
   Windows).  It allows copying CDDA audio data from the CDROM drive  into
   a file in WAV or other formats.

   The  latest  versions try to get higher real-time scheduling priorities
   to  ensure  smooth  (uninterrupted)  operation.  These  priorities  are
   available  for  super  users  and  are  higher  than  those of 'normal'
   processes. Thus delays are minimized.

   If your CDROM is on device DEV and it is loaded with an audio  CD,  you
   may  simply  invoke  icedax  dev=DEV  and it will create the sound file
   audio.wav recording the whole track beginning with track 1 in stereo at
   16  bit  at  44100 Hz sample rate, if your file system has enough space
   free.  Otherwise recording time will be limited. For details see  files
   README and README.INSTALL

HINTS ON OPTIONS

   Options
          Most  of  the  options are used to control the format of the WAV
          file. In the following text all of them are described.

   Select Device
          -D device selects the  CDROM  drive  device  to  be  used.   The
          specifier given should correspond to the selected interface (see
          below).  CHANGE!  For the cooked_ioctl  interface  this  is  the
          cdrom  device  descriptor as before.  The SCSI devices used with
          the generic SCSI interface however are now addressed with  their
          SCSI-Bus,  SCSI-Id,  and  SCSI-Lun  instead  of the generic SCSI
          device descriptor!!!  One example for a SCSI CDROM drive on  bus
          0 with SCSI ID 3 and lun 0 is -D0,3,0.

   Select Auxiliary device
          -A  auxdevice  is necessary for CD-Extra handling. For Non-SCSI-
          CDROM drives this is the same device as given by -D (see above).
          For  SCSI-CDROM drives it is the CDROM drive (SCSI) device (i.e.
          /dev/sr0 ) corresponding to the SCSI device (i.e.  0,3,0  ).  It
          has to match the device used for sampling.

   Select Interface
          -I  interface selects the CDROM drive interface. For SCSI drives
          use generic_scsi (cooked_ioctl may not yet be available for  all
          devices):  generic_scsi  and  cooked_ioctl.   The first uses the
          generic SCSI interface, the latter uses the ioctl of  the  CDROM
          driver.  The  latter  variant  works only when the kernel driver
          supports CDDA reading. This entry  has  to  match  the  selected
          CDROM device (see above).

   Enable echo to soundcard
          -e  copies  audio data to the sound card while recording, so you
          hear it nearly simultaneously. The soundcard gets the same  data
          that  is  recorded. This is time critical, so it works best with
          the -q option.  To use icedax as  a  pseudo  CD  player  without
          recording  in  a  file  you could use icedax -q -e -t2 -d0 -N to
          play the whole second track. This feature reduces the  recording
          speed   to  at  most  onefold  speed.  You  cannot  make  better
          recordings than your sound card can play (since the same data is
          used).

   Change pitch of echoed audio
          -p  percentage  changes the pitch of all audio echoed to a sound
          card. Only the copy to the soundcard is affected,  the  recorded
          audio samples in a file remain the same.  Normal pitch, which is
          the default, is given by 100%.  Lower percentages correspond  to
          lower  pitches,  i.e.   -p  50  transposes  the audio output one
          octave lower.  See also the script pitchplay as an example. This
          option was contributed by Raul Sobon.

   Select mono or stereo recording
          -m  or  -c  1  selects  mono recording (both stereo channels are
          mixed), -s or -c 2 or -c s selects stereo recording. Parameter s
          will swap both sound channels.

   Select maximum quality
          -x  will  set  stereo,  16  bits per sample at 44.1 KHz (full CD
          quality).  Note that other format options given later can change
          this setting.

   Select sample quality
          -b  8  specifies 8 bit (1 Byte) for each sample in each channel;
          -b 12 specifies 12 bit (2 Byte) for each sample in each channel;
          -b  16 specifies 16 bit (2 Byte) for each sample in each channel
          (Ensure that your sample player or  sound  card  is  capable  of
          playing  12-bit  or  16-bit  samples).  Selecting  12 or 16 bits
          doubles  file  size.   12-bit  samples  are  aligned  to  16-bit
          samples, so they waste some disk space.

   Select sample rate
          -r  samplerate  selects  a  sample rate.  samplerate can be in a
          range between 44100 and  900.  Option  -R  lists  all  available
          rates.

   Select sample rate divider
          -a  divider  selects  a  sample  rate  divider.   divider can be
          minimally 1 and maximally 50.5 and everything between  in  steps
          of 0.5.  Option -R lists all available rates.

          To  make the sound smoother at lower sampling rates, icedax sums
          over n samples (where n is the specific dividend). So for  22050
          Hertz  output  we  have  to sum over 2 samples, for 900 Hertz we
          have to sum over 49 samples.  This cancels  higher  frequencies.
          Standard  sector  size  of  an  audio  CD  (ignoring  additional
          information) is 2352 Bytes. In order to finish  summing  for  an
          output  sample  at  sector boundaries the rates above have to be
          chosen.  Arbitrary sampling rates in high quality would  require
          some  interpolation  scheme, which needs much more sophisticated
          programming.

   List a table of all sampling rates
          -R shows a list of all sample rates and their dividers. Dividers
          can range from 1 to 50.5 in steps of 0.5.

   Select start track and optionally end track
          -t n+m selects n as the start track and optionally m as the last
          track of a range to be recorded.  These tracks must be from  the
          table  of contents.  This sets the track where recording begins.
          Recording can advance  through  the  following  tracks  as  well
          (limited  by  the  optional  end track or otherwise depending on
          recording time). Whether one file or different  files  are  then
          created depends on the -B option (see below).

   Select start index
          -i  n  selects the index to start recording with.  Indices other
          than 1 will invoke the index scanner, which will take some  time
          to  find  the  correct  start  position.  An offset may be given
          additionally (see below).

   Set recording time
          -d  n sets recording time to n seconds or set recording time for
          whole  track  if  n is zero. In order to specify the duration in
          frames (sectors) also, the argument can have  an  appended  'f'.
          Then  the  numerical argument is to be taken as frames (sectors)
          rather than seconds.  Please note that if track ranges are being
          used  they define the recording time as well thus overriding any
          -d option specified times.

          Recording time is defined as the time the generated sample  will
          play  (at  the  defined  sample rate). Since it's related to the
          amount of generated samples, it's not the time of  the  sampling
          process  itself  (which  can  be  less  or  more).  It's neither
          strictly coupled with the  time  information  on  the  audio  CD
          (shown  by  your  hifi CD player).  Differences can occur by the
          usage of the -o option (see below). Notice that  recording  time
          will  be  shortened,  unless enough disk space exists. Recording
          can be aborted  at  anytime  by  pressing  the  break  character
          (signal SIGQUIT).
             .IP  "Record  all  tracks  of a complete audio CD in separate
          files" -B copies each track into a separate file.  A  base  name
          can  be  given.  File names have an appended track number and an
          extension corresponding to the audio format. To record all audio
          tracks of a CD, use a sufficient high duration (i.e. -d99999).

   Set start sector offset
          -o  sectors increments start sector of the track by sectors.  By
          this option you are  able  to  skip  a  certain  amount  at  the
          beginning  of a track so you can pick exactly the part you want.
          Each sector runs  for  1/75  seconds,  so  you  have  very  fine
          control.  If  your  offset is so high that it would not fit into
          the current track, a warning message is issued and the offset is
          ignored.   Recording time is not reduced.  (To skip introductory
          quiet passages automagically, use the -w option see below.)

   Wait for signal option
          -w Turning on this option will suppress  all  silent  output  at
          startup, reducing possibly file size.  icedax will watch for any
          signal in the output signal and switches on writing to file.

   Find extreme samples
          -F Turning on this option will display the most negative and the
          most  positive  sample  value  found  during  recording for both
          channels. This can be useful for  readjusting  the  volume.  The
          values  shown  are not reset at track boundaries, they cover the
          complete sampling process. They  are  taken  from  the  original
          samples  and  have the same format (i.e. they are independent of
          the selected output format).

   Find if input samples are in mono
          -G If this option is given, input samples for both channels will
          be  compared.  At  the end of the program the result is printed.
          Differences in the channels indicate stereo, otherwise when both
          channels are equal it will indicate mono.

   Undo the pre-emphasis in the input samples
          -T  Some  older audio CDs are recorded with a modified frequency
          response called pre-emphasis. This is found mostly in  classical
          recordings. The correction can be seen in the flags of the Table
          Of Contents often. But there  are  recordings,  that  show  this
          setting  only  in  the subchannels. If this option is given, the
          index scanner will be started, which reads the  q-subchannel  of
          each  track. If pre-emphasis is indicated in the q-subchannel of
          a track, but not in the TOC, pre-emphasis will be assumed to  be
          present,  and  subsequently a reverse filtering is done for this
          track before the samples are written into the audio file.

   Set audio format
          -O  audiotype can be wav (for wav files) or au or sun  (for  sun
          PCM files) or cdr or raw (for headerless files to be used for cd
          writers).  All file samples  are  coded  in  linear  pulse  code
          modulation  (as  done  in  the  audio compact disc format). This
          holds for all  audio  formats.   Wav  files  are  compatible  to
          Wind*ws  sound files, they have lsb,msb byte order as being used
          on the audio cd. The default filename extension is '.wav'.   Sun
          type  files  are not like the older common logarithmically coded
          .au files, but instead as mentioned above linear  PCM  is  used.
          The byte order is msb,lsb to be compatible. The default filename
          extension is '.au'.  The AIFF and the newer  variant  AIFC  from
          the  Apple/SGI  world  store  their  samples in bigendian format
          (msb,lsb). In AIFC no compression is used.  Finally the  easiest
          'format',  the  cdr  aka  raw  format. It is done per default in
          msb,lsb byte order to  satisfy  the  order  wanted  by  most  cd
          writers.  Since  there  is no header information in this format,
          the sample parameters can only  be  identified  by  playing  the
          samples   on  a  soundcard  or  similar.  The  default  filename
          extension is '.cdr' or '.raw'.

   Select cdrom drive reading speed
          -S  speed allows to switch the cdrom drive to a certain level of
          speed in order to reduce read errors. The argument is transfered
          verbatim to the drive.  Details depend very much  on  the  cdrom
          drives.  An argument of 0 for example is often the default speed
          of the drive, a value of 1 often selects single speed.

   Enable MD5 checksums
          -M  count enables calculation of MD-5 checksum for 'count' bytes
          from  the  beginning  of  a track. This was introduced for quick
          comparisons of tracks.

   Use Monty's libparanoia for reading of sectors
          -paranoia selects an alternate way of extracting audio  sectors.
          Monty's library is used with the following default options:

          PARANOIA_MODE_FULL, but without PARANOIA_MODE_NEVERSKIP

          for details see Monty's libparanoia documentation.  In this case
          the option -P has no effect.

   Do linear or overlapping reading of sectors
          (This applies unless option -paranoia  is  used.)   -P   sectors
          sets  the  given  number of sectors for initial overlap sampling
          for jitter correction. Two cases are to  be  distinguished.  For
          nonzero  values,  some sectors are read twice to enable icedax's
          jitter correction.  If an argument of zero is given, no  overlap
          sampling  will  be  used.   For  nonzero  overlap sectors icedax
          dynamically adjusts the setting during sampling (like cdparanoia
          does).   If  no match can be found, icedax retries the read with
          an increased overlap.  If the amount of jitter is lower than the
          current  overlapped samples, icedax reduces the overlap setting,
          resulting in a higher reading speed.  The argument given has  to
          be  lower  than  the  total  number  of sectors per request (see
          option -n below).  Icedax will check this setting and  issues  a
          error  message  otherwise.   The case of zero sectors is nice on
          low load situations or  errorfree  (perfect)  cdrom  drives  and
          perfect (not scratched) audio cds.

   Set the transfer size
          -n   sectors will set the transfer size to the specified sectors
          per request.

   Set number of ring buffer elements
          -l  buffers will allocate the specified number  of  ring  buffer
          elements.

   Set endianess of input samples
          -C   endianess  will  override the default settings of the input
          format.  Endianess can be set explicitly to "little" or "big" or
          to  the  automatic  endianess  detection  based  on  voting with
          "guess".

   Set endianess of output samples
          -E  endianess (endianess can be "little" or "big") will override
          the default settings of the output format.

   Verbose option
          -v  itemlist prints more information. A list allows selection of
          different information items.

          disable keeps quiet

          toc displays the table of contents

          summary displays a summary of recording parameters

          indices invokes the index scanner and displays  start  positions
          of indices

          catalog retrieves and displays a media catalog number

          trackid  retrieves and displays international standard recording
          codes

          sectors  displays  track  start  positions  in  absolute  sector
          notation

          To  combine  several requests just list the suboptions separated
          with commas.

   The table of contents
          The display will show the  table  of  contents  with  number  of
          tracks and total time (displayed in mm:ss.hh format, mm=minutes,
          ss=seconds,  hh=rounded  1/100  seconds).   The  following  list
          displays  track  number  and  track  time  for  each entry.  The
          summary gives a line per track describing the type of the track.

                  track preemphasis copypermitted tracktype chans

          The track column holds the track number.  preemphasis  shows  if
          that  track  has  been  given  a  non linear frequency response.
          NOTE: You can undo  this  effect  with  the  -T  option.   copy-
          permitted indicates if this track is allowed to copy.  tracktype
          can be data or audio. On multimedia  CDs  (except  hidden  track
          CDs)  both  of  them should be present.  channels is defined for
          audio tracks only. There can be two or four channels.

   No file output
          -N this debugging option switches off writing to a file.

   No infofile generation
          -H this option switches off creation of an info file and a  cddb
          file.

   Generation of simple output for gui frontends
          -g  this  option  switches  on  simple line formatting, which is
          needed to support gui frontends (like xcd-roast).

   Verbose SCSI logging
          -V this option switches on logging of SCSI commands.  This  will
          produce  a  lot  of  output  (when SCSI devices are being used).
          This is needed for debugging purposes. The format is the same as
          being used with the cdrecord program from Joerg Schilling or the
          wodim tool. See there for details.

   Quiet option
          -q suppresses all screen output  except  error  messages.   That
          reduces cpu time resources.

   Just show information option
          -J  does  not write a file, it only prints information about the
          disc (depending on the -v option). This is just for  information
          purposes.

CDDBP support

   Lookup album and track titles option
          -L   cddbp  mode Icedax tries to retrieve performer, album-, and
          track titles from a cddbp server. The default server  right  now
          is 'freedb.freedb.org'.  It is planned to have more control over
          the server handling later.  The parameter defines  how  multiple
          entries are handled:

   0        interactive mode, the user chooses one of the entries.

   1        take the first entry without asking.

   Set server for title lookups
          cddbp-server   servername  When  using  -L or --cddb, the server
          being contacted can be set with this option.

   Set portnumber for title lookups
          cddbp-port  portnumber When using -L or --cddb, the server  port
          being contacted can be set with this option.

HINTS ON USAGE

   Don't  create  samples  you cannot read. First check your sample player
   software and sound card hardware. I experienced problems with very  low
   sample  rates  (stereo <= 1575 Hz, mono <= 3675 Hz) when trying to play
   them with standard WAV players for sound blaster (maybe  they  are  not
   legal  in  WAV  format).  Most  CD-Writers insist on audio samples in a
   bigendian format.  Now icedax supports  the  -E   endianess  option  to
   control the endianess of the written samples.

   If your hardware is fast enough to run icedax uninterrupted and your CD
   drive is one of the 'perfect' ones, you will gain speed when  switching
   all overlap sampling off with the -P  0 option. Further fine tuning can
   be done with the -n  sectors option. You can specify how  much  sectors
   should be requested in one go.

   Icedax supports pipes now. Use a filename of - to let icedax output its
   samples to standard output.

   Conversion to other sound formats can be done  using  the  sox  program
   package (although the use of sox -x to change the byte order of samples
   should be no more  necessary;  see  option  -E  to  change  the  output
   byteorder).

   If  you  want to sample more than one track into different files in one
   run, this is currently possible with the -B option. When recording time
   exceeds the track limit a new file will be opened for the next track.

FILES

   Icedax can generate a lot of files for various purposes.

   Audio files:

   There  are audio files containing samples with default extensions These
   files are not generated when option (-N) is given. Multiple  files  may
   be  written  when  the  bulk  copy option (-B) is used. Individual file
   names can be given as arguments. If the number of file names  given  is
   sufficient  to  cover all included audio tracks, the file names will be
   used verbatim.  Otherwise, if there are  less  file  names  than  files
   needed  to  write the included tracks, the part of the file name before
   the extension is extended with '_dd' where dd  represents  the  current
   track number.

   Cddb and Cdindex files:

   If  icedax detects cd-extra or cd-text (album/track) title information,
   then .cddb and .cdindex files are generated unless  suppressed  by  the
   option  -H.  They  contain suitable formatted entries for submission to
   audio cd track  title  databases  in  the  internet.  The  CDINDEX  and
   CDDB(tm)  systems  are currently supported. For more information please
   visit www.musicbrainz.org and www.freedb.com.

   Inf files:

   The inf files are describing the sample files and  the  part  from  the
   audio  cd,  it was taken from. They are a means to transfer information
   to a cd burning program like wodim. For example, if the original  audio
   cd had pre-emphasis enabled, and icedax -T did remove the pre-emphasis,
   then the inf file has pre-emphasis not set (since the audio  file  does
   not  have  it  anymore),  while  the  .cddb  and the .cdindex have pre-
   emphasis set as the original does.

WARNING

   IMPORTANT: it is prohibited to sell copies of copyrighted  material  by
   noncopyright  holders.  This  program  may  not  be  used to circumvent
   copyrights.  The user  acknowledges  this  constraint  when  using  the
   software.

BUGS

   Generation of md5 checksums is currently broken.

   Performance may not be optimal on slower systems.

   The index scanner may give timeouts.

   The  resampling  (rate  conversion code) uses polynomial interpolation,
   which is not optimal.

   Icedax should use threads.

   Icedax currently cannot sample hidden audio tracks (track 1 index 0).

ACKNOWLEDGEMENTS

   Thanks goto Project MODE (http://www.mode.net/) and Fraunhofer Institut
   fuer  integrierte  Schaltungen  (FhG-IIS)  (http://www.iis.fhg.de/) for
   financial support.  Plextor Europe and Ricoh Japan provided cdrom  disk
   drives  and  cd  burners  which  helped a lot to develop this software.
   Rammi has helped a lot with the debugging and showed a lot  of  stamina
   when  hearing  100 times the first 16 seconds of the first track of the
   Krupps CD.  Libparanoia contributed by Monty  (Christopher  Montgomery)
   xiphmont@mit.edu.

AUTHOR

   Heiko Eissfeldt heiko@colossus.escape.de

   This  manpage describes the program implementation of icedax as shipped
   by           the           cdrkit           distribution.           See
   http://alioth.debian.org/projects/debburn/ for details. It is a spinoff
   from the original program  cdda2wav  as  distributed  in  the  cdrtools
   package  [1].  However, the cdrtools developers are not involved in the
   development of this spinoff and therefore shall not be made responsible
   for  any  problem  caused  by  it.  Do  not try to get support for this
   program by contacting the original authors.

   If you have support questions, send them to

   debburn-devel@lists.alioth.debian.org

   If you have definitely found a bug, send a mail to this list or to

   submit@bugs.debian.org

   writing at least a short description into  the  Subject  and  "Package:
   cdrkit" into the first line of the mail body.

DATE

   26 Sep 2006

SOURCES

   [1] Cdrtools 2.01.01a08 from May 2006, http://cdrecord.berlios.de

                                                                 ICEDAX(1)





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.