home *** CD-ROM | disk | FTP | other *** search
/ Geek 6 / Geek-006.iso / linux / cds / cdparanoia-III.alpha9.7-1.i386.rpm / cdparanoia-III.alpha9.7.1.cpio.gz / cdparanoia-III.alpha9.7.1.cpio / usr / doc / cdparanoia-III.alpha9.7 / README
Text File  |  1999-12-14  |  7KB  |  190 lines
  1. cdparanoia release III alpha 9 README
  2. [March 19, 1998, updated December 13, 1999]
  3.  
  4. Monty <monty@xiph.org>
  5.  
  6. This CDDA reader distribution ('cdparanoia') reads audio from the
  7. CDROM directly as data, with no analog step between, and writes the
  8. data to a file or pipe as .wav, .aifc or as raw 16 bit linear PCM.
  9.  
  10. These are installation notes; for lots of other cdparanoia related
  11. information, see:
  12.  
  13. http://www.xiph.org/paranoia/
  14.  
  15. Requirements
  16. ============
  17.  
  18. 1. A CDDA capable CDROM drive (ATAPI, SCSI, or proprietary)
  19.  
  20. 2. For proprietary drives:
  21.    2a. kernel support for the particular CDROM in use
  22.    
  23.    For ATAPI CDROM drives:
  24.    2b. IDE cdrom (ATAPI) support
  25.     (*or*)
  26.    2c. IDE-SCSI host adaptor emulation 
  27.    2d. SCSI cdrom support (optional)
  28.    2e. kernel support for the generic SCSI interface and proper device 
  29.     (/dev/sg?) files in /dev. Most distributions already have the 
  30.     /dev/sg? files.
  31.  
  32.    For SCSI CDROM drives:
  33.    2f. SCSI cdrom support (optional)
  34.    2g. kernel support for the generic SCSI interface and proper device 
  35.     (/dev/sg?) files in /dev. Most distributions already have the 
  36.     /dev/sg? files.
  37.  
  38. 3. A Linux 2.0.x, 2.1.x, 2.2.x or 2.3.x kernel
  39.  
  40. ATAPI drives may be used either with the native IDE cdrom driver, or
  41. with IDE-SCSI host adaptor emulation.  Both work, but the SCSI
  42. emulation mode works much better for CDDA extraction.  Cdparanoia may
  43. also be able to identify and use unusual drives that report 'CDDA
  44. incapable' in native ATAPI mode.
  45.  
  46. Linux 2.0.x only: Also, although a stock SCSI setup may work,
  47. performance will be better if linux/include/scsi/sg.h defines
  48. SG_BIG_BUFF to 65536.
  49.  
  50. /proc filesystem support is no longer needed, although you'll
  51. certainly want to have it for other packages.  Cdparanoia does not
  52. require threading, IPC or sound card support.
  53.  
  54. Compiling cdparanoia
  55. ==================
  56.  
  57. To build the cdparanoia utility:
  58.  
  59.     ./configure
  60.     make all
  61.     
  62. This will compile cdparanoia and the shared paranoia libs; make
  63. install (as root) will install it. Don't forget to run ldconfig;
  64. unlike previous releases, this version uses shared paranoia libs; you
  65. can still build the static version as follows:
  66.  
  67.     ./configure
  68.     make all STATIC=TRUE
  69.  
  70. Unlike cdda2wav and readcdda, cdparanoia is smart enough to find CDROM
  71. drives and the appropriate interfaces automatically; if you have only
  72. one CDROM drive, you'll not need to worry about it.  If your machine
  73. has more than one CDROM drive and cdparanoia finds the wrong one,
  74. you'll need to tell it which device to use on the command line (see
  75. the man page and Troubleshooting below).
  76.  
  77. To build the cdda_interface.a and cdda_paranoia.a libraries:
  78.  
  79.     ./configure
  80.     make lib
  81.  
  82. The .so shared libraries can be built as follows:
  83.  
  84.     ./configure
  85.     make slib
  86.  
  87. Other build notes (such as building and using a debugging version of
  88. cdparanoia to aid me in tracking down any trouble) can be found on the
  89. Cdparanoia web site at the URL given above.
  90.  
  91. Additional installation notes
  92. =============================
  93.  
  94. Most Linux setups already have performed the steps described below.
  95. The list is useful for doublechecking. (originally taken from Heiko's 
  96. cdda2wav README)
  97.  
  98. (for SCSI devices)
  99.  
  100.   Cdparanoia requires the generic SCSI interface; you'll need
  101.   a kernel with compiled-in or module-supplied sg interface.
  102.   In case of a module, this has to be loaded ('modprobe sg'; 
  103.   usually done in boot time scripts).
  104.   This can be verified with 'cat /proc/devices'. It should
  105.   have a line under Character devices:
  106.   21 sg
  107.  
  108.   Cdparanoia also uses (but doesn't really require) the kernel SCSI
  109.   cdrom driver, ie, a kernel with compiled-in or module-supplied 
  110.   cdrom support. In case of a module, this has to be loaded 
  111.   ('modprobe sr_mod'; again, usually part of boot up scripts).
  112.   This can be verified with 'cat /proc/devices'. It should
  113.   have a line under Block devices:
  114.   11 sr
  115.  
  116.   If the modules are properly configured but not currently loaded, 
  117.   cdparanoia will trigger loading during its autoscanning.
  118.  
  119.   In the /dev directory there have to be these descriptors:
  120.   br--------   1 cduser   user      11,   0 Jan 23  1995 sr0
  121.   br--------   1 cduser   user      11,   1 Mar 24  1993 sr1
  122.   etc...
  123.  
  124.   and
  125.   crw-------   1 cduser   user      21,   0 Aug 27  1995 sga
  126.   crw-------   1 cduser   user      21,   1 Aug 27  1995 sgb
  127.   crw-------   1 cduser   user      21,   2 Aug 27  1995 sgc
  128.   etc...
  129.  
  130.   and a link named 'cdrom' to the cdrom drive used.  The link can be
  131.   to the cdrom device *or* the generic device.  The link isn't required,
  132.   but it will speed autodetection.
  133.  
  134.   Permissions and ownership can be changed at will, of course.
  135.   Here access is permitted only to user 'cduser'.
  136.  
  137. (for ATAPI and proprietary cdrom devices)
  138.  
  139.   The kernel must have compiled-in or module-supplied cdrom support.
  140.   In case of a module, this has to be loaded ('modprobe <modulename>';
  141.   this is normally included in the boot-up scripts).
  142.   This can be verified with 'cat /proc/devices'. It should
  143.   have a line under Block devices:
  144.   <major> <name of cdrom driver>
  145.  
  146.   In the /dev directory there have to be these descriptors:
  147.   br--------   1 cduser   user <major>,   0 Jan 23  1995 <cdrom device 1>
  148.   br--------   1 cduser   user <major>,   1 Mar 24  1993 <cdrom device 2>
  149.   etc...
  150.  
  151.   a link named 'cdrom' to the cdrom drive used will speed up the
  152.   process of finding the cdrom (cdparanoia checks for the link first)
  153.  
  154.   These steps are usually performed automatically during the
  155.   installation of Linux.
  156.  
  157. (for ATAPI cdrom drives using IDE-SCSI host adaptor emulation)
  158.  
  159.   Overall, the instructions are the same as for normal SCSI drives.
  160.   To cause the CDROM drive to appear as a SCSI device instead of ATAPI,
  161.   the kernel must be compiled *with* SCSI and generic SCSI support, and
  162.   *without* IDE CDROM drive (ATAPI) support.  If native ATAPI support is
  163.   enabled, the kernel will always choose to use the native ATAPI driver.
  164.  
  165. "Missing Features:
  166. ==================
  167.  
  168. Specifically, 'cdparanoia' will not play to sound cards, do MD5
  169. signatures, do rate reduction, or generally make use of the maximum
  170. speed available from a CDROM drive.  If your CDROM drive is *not*
  171. prone to jitter and you don't have scratched discs to worry about,
  172. look into Heiko's original cdda2wav.
  173.  
  174. Troubleshooting
  175. ===============
  176.  
  177. lots o' stuff on the website.
  178.  
  179. Contacts
  180. ========
  181.  
  182. I can be contacted at monty@xiph.org.  The main distribution site
  183. for cdparanoia (and the original Paranoia patches to cdda2wav) is
  184. http://www.xiph.org/paranoia/
  185.  
  186. Happy hunting.  Be nice to copyrights.
  187.  
  188. Monty
  189.  
  190.