cdparanoia release III alpha 9 README [March 19, 1998, updated March 27, 2001] Monty This CDDA reader distribution ('cdparanoia') reads audio from the CDROM directly as data, with no analog step between, and writes the data to a file or pipe as .wav, .aifc or as raw 16 bit linear PCM. These are installation notes; for lots of other cdparanoia related information, see: http://www.xiph.org/paranoia/ Requirements ============ 1. A CDDA capable CDROM drive (ATAPI, SCSI, or proprietary) 2. For proprietary drives: 2a. kernel support for the particular CDROM in use For ATAPI CDROM drives: 2b. IDE cdrom (ATAPI) support (*or*) 2c. IDE-SCSI host adaptor emulation 2d. SCSI cdrom support (optional) 2e. kernel support for the generic SCSI interface and proper device (/dev/sg?) files in /dev. Most distributions already have the /dev/sg? files. devfs [supported] sets this up automagically. For SCSI CDROM drives: 2f. SCSI cdrom support (optional) 2g. kernel support for the generic SCSI interface and proper device (/dev/sg?) files in /dev. Most distributions already have the /dev/sg? files. devfs [supported] sets this up automagically. 3. A Linux 2.2.x, 2.3.x or 2.4.x kernel ATAPI drives may be used either with the native IDE cdrom driver, or with IDE-SCSI host adaptor emulation. Both work, but the SCSI emulation mode works much better for CDDA extraction. Cdparanoia may also be able to identify and use unusual drives that report 'CDDA incapable' in native ATAPI mode. /proc filesystem support is no longer needed, although you'll certainly want to have it for other packages. Cdparanoia does not require threading, IPC or sound card support. Devfs is fully supported as of 9.8, with or without devfsd. Compiling cdparanoia ================== To build the cdparanoia utility: ./configure make all This will compile cdparanoia and the shared paranoia libs; make install (as root) will install it. Don't forget to run ldconfig; unlike previous releases, this version uses shared paranoia libs; you can still build the static version as follows: ./configure make all STATIC=TRUE Unlike cdda2wav and readcdda, cdparanoia is smart enough to find CDROM drives and the appropriate interfaces automatically; if you have only one CDROM drive, you'll not need to worry about it. If your machine has more than one CDROM drive and cdparanoia finds the wrong one, you'll need to tell it which device to use on the command line (see the man page and Troubleshooting below). To build the cdda_interface.a and cdda_paranoia.a libraries: ./configure make lib The .so shared libraries can be built as follows: ./configure make slib Other build notes (such as building and using a debugging version of cdparanoia to aid me in tracking down any trouble) can be found on the Cdparanoia web site at the URL given above. Additional installation notes ============================= Most Linux setups already have performed the steps described below, and devfs also provides all the necessary device entries automatically. The list is useful for doublechecking on a non-devfs install. (originally taken from Heiko's cdda2wav README) (for SCSI devices) Cdparanoia requires the generic SCSI interface; you'll need a kernel with compiled-in or module-supplied sg interface. In case of a module, this has to be loaded ('modprobe sg'; usually done in boot time scripts). This can be verified with 'cat /proc/devices'. It should have a line under Character devices: 21 sg Cdparanoia also uses (but doesn't really require) the kernel SCSI cdrom driver, ie, a kernel with compiled-in or module-supplied cdrom support. In case of a module, this has to be loaded ('modprobe sr_mod'; again, usually part of boot up scripts). This can be verified with 'cat /proc/devices'. It should have a line under Block devices: 11 sr If the modules are properly configured but not currently loaded, cdparanoia will trigger loading during its autoscanning. In the /dev directory there have to be these descriptors: br-------- 1 cduser user 11, 0 Jan 23 1995 sr0 br-------- 1 cduser user 11, 1 Mar 24 1993 sr1 etc... and crw------- 1 cduser user 21, 0 Aug 27 1995 sga crw------- 1 cduser user 21, 1 Aug 27 1995 sgb crw------- 1 cduser user 21, 2 Aug 27 1995 sgc etc... and a link named 'cdrom' to the cdrom drive used. The link can be to the cdrom device *or* the generic device. The link isn't required, but it will speed autodetection. Permissions and ownership can be changed at will, of course. Here access is permitted only to user 'cduser'. (for ATAPI and proprietary cdrom devices) The kernel must have compiled-in or module-supplied cdrom support. In case of a module, this has to be loaded ('modprobe '; this is normally included in the boot-up scripts). This can be verified with 'cat /proc/devices'. It should have a line under Block devices: In the /dev directory there have to be these descriptors: br-------- 1 cduser user , 0 Jan 23 1995 br-------- 1 cduser user , 1 Mar 24 1993 etc... a link named 'cdrom' to the cdrom drive used will speed up the process of finding the cdrom (cdparanoia checks for the link first) These steps are usually performed automatically during the installation of Linux. (for ATAPI cdrom drives using IDE-SCSI host adaptor emulation) Overall, the instructions are the same as for normal SCSI drives. To cause the CDROM drive to appear as a SCSI device instead of ATAPI, the kernel must be compiled *with* SCSI and generic SCSI support, and *without* IDE CDROM drive (ATAPI) support. If native ATAPI support is enabled, the kernel will always choose to use the native ATAPI driver. "Missing Features: ================== Specifically, 'cdparanoia' will not play to sound cards, do MD5 signatures, do rate reduction, or generally make use of the maximum speed available from a CDROM drive. If your CDROM drive is *not* prone to jitter and you don't have scratched discs to worry about, look into Heiko's original cdda2wav. Troubleshooting =============== lots o' stuff on the website. Contacts ======== I can be contacted at monty@xiph.org. The main distribution site for cdparanoia (and the original Paranoia patches to cdda2wav) is http://www.xiph.org/paranoia/ Happy hunting. Be nice to copyrights. Monty