Cdrdao - Write audio/data CD-Rs in disk-at-once mode
=============================================================================

This file contains some additional information. See the manual page
for usage of the tool.

Please use the write simulation mode (command 'simulate') when trying
this program the first time on your system. This will detect problems
or incompatibilities without wasting a CD-recordable. Note that you
may have to eject and reinsert the CD-R after a simulation run before
a real write can start.


Sources of Information
---------------------

Cdrdao Homepage: http://cdrdao.sourceforge.net/
                 
Download:        http://sourceforge.net/projects/cdrdao/

Mailing Lists:

  cdrdao-info@lists.sourceforge.net
    Moderated list for informing about new releases or serious bugs.
    For subscribing information send an email with 'help' in the body
    to <cdrdao-info-request@lists.sourceforge.net> or visit the info page
    http://lists.sourceforge.net/mailman/listinfo/cdrdao-info.

  cdrdao-devel@lists.sourceforge.net
    Open lists for discussion about problems, implementation of new
    features etc. 
    For subscribing information send an email with 'help' in the body
    to <cdrdao-devel-request@lists.sourceforge.net> or visit the info page
    http://lists.sourceforge.net/mailman/listinfo/cdrdao-devel.
    

Please report bugs and suggestions to Denis Leroy <denis@poolshark.org>.



Drivers
-------

The following driver IDs may be used with option '--driver'. It is
possible to specify option bits which modify the behavior of the
driver. Global and driver specific options are available. Options
flags can be combined by logical 'or' and appended to the '--driver'
option, e.g.  '--driver plextor-scan:0x03'.

By default, cdrdao will try to detect if your device is MMC compliant
and use the 'generic-mmc' driver is possible.

  Global Option Bits:
     read-toc/read-cd related:
        0x00010000: Use the generic method to read the TOC of a CD for
                    commands 'read-toc' and 'read-cd'. If this flag is
                    selected multi session disks will not be handled
                    properly but some drives do not work with the
                    currently implemented method for reading the TOC
                    of a specific session.

        0x00020000: If the byte order of the audio data retrieved with 
                    'read-cd' is wrong (i.e. not big endian samples) use
                    this option.

        0x00040000: Use this option if your drive cannot read audio data
                    from the first track's pre-gap. You will get read error
                    messages in this case which should vanish if this option
                    is used.

        0x00080000: Suppresses the automatic data type detection for the
                    raw TOC data and assumes that the drive sends BCD data.
                    Use this or the following option if cdrdao reports that
                    it cannot "determine if raw toc data is BCD or HEX".

        0x00100000: Suppresses the automatic data type detection for the
                    raw TOC data and assumes that the drive sends HEX data.
                    Use this or the previous option if cdrdao reports that
                    it cannot "determine if raw toc data is BCD or HEX".

        0x00200000: Do not try to read CD-TEXT data with command 'read-toc',
                    'read-cd' or 'copy'. Some drives lock up or send junk
                    data when asked for the CD-TEXT data. 

  Available Drivers:

  plextor
     Supports CD structure analysis (command 'read-toc') for Plextor
     CD-ROM readers. Pre-gaps and index marks are detected by
     performing a binary search over the Q sub-channel for each
     track. This method is fast and gives very exact results on
     Plextor drives. The driver uses generic SCSI commands (PLAY AUDIO
     and READ SUB-CHANNEL) so it may work on other models, too, but
     result and speed is directly correlated to the digital audio
     extraction capabilities.

     Option Bits:
        read-toc/read-cd related:
           0x00000001: Force usage of the paranoia method for audio extraction
                       instead of the special Plextor method that is used
                       with Plextor drives.

           0x00000002: Use the READ10 command to read audio data instead of
                       the vendor specific READ CDDA command.
                       Only used if the paranoia DAE method is selected.

		   0x00000010: Don't slow down after a read error. Available
                               only on Plextor devices. Manufacturer
                               default is to slow down.

		   0x00000020: Start data transfer before maximum
                               speed is reached. Available only on
                               Plextor PX-20 and later. Manufacturer
                               default is to wait for maximum speed.

		   0x00000040: Don't slow down when drive pauses to
                               avoid vibrations. Available only on
                               Plextor PX-20 and later. Manufacturer
                               default is to slow down.
 
  plextor-scan
     This is an alternate driver for CD structure analysis with Plextor
     drives. It scans the Q sub-channels of a track linearly like the 
     'generic-mmc' driver but is faster on Plextor drives.

     Option Bits:
        read-toc/read-cd related:
           0x00000001: Read 16 bytes PQ sub-channel instead of 96 byte
                       raw P-W sub-channel data. If 'read-toc'/'read-cd'
                       fails on your drive try to select this option.
                       
           0x00000002: Only used if option '0x00000001' is selected. If set
                       the read PQ sub-channel data is expected to contain
                       BCD instead of HEX values. If the time count that
                       is displayed while running 'read-toc' jumps you will
                       have to toggle this option.

           0x00000004: Do not take ISRC code from the sub-channel data but use
                       the appropriate SCSI command for reading the ISRC 
                       code. This option is automatically selected if 16
                       byte PQ sub-channel data with HEX values is used.

  cdd2600
     This is a native driver for the Philips CDD2000/CDD2600 drive family.
     'read-toc' is implemented like in the 'plextor' driver but it is slow
     and not very exact due to poor digital audio extraction capabilities of
     these drives. Anyway, I don't recommend doing CD structure analysis with
     the CDD2x00 because it stresses the mechanism too much. 

  generic-mmc
     This is a driver for SCSI-3/mmc compatible CD-recorders that support
     session-at-once (cue sheet based) writing. Most of the recent drives
     (ATAPI, SCSI, USB, Parallel Port) should be compatible with this or
     with the 'generic-mmc-raw' driver described below. Data track writing
     support is also available.
     'read-toc' scans linearly the Q sub-channel of each track to retrieve
     the pre-gap length and index marks. This method is very accurate but
     takes the same time like digital audio extraction. It should also work
     with recent CD-ROM readers.

     Option Bits:
        read-toc/read-cd related:
           0x00000001: See 'plextor-scan'.
                       
           0x00000002: See 'plextor-scan'.

           0x00000004: See 'plextor-scan'.

           0x00000008: Try to retrieve the media catalog number by scanning
                       the sub-channels instead of using the appropriate
                       SCSI command. This might be an option if the CD-R/CD-ROM
                       drive does not extract the catalog number ot                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       