building/installing cripple
~~~~~~~~~~~~~~~~~~~~~~~~~~~

For the impatient try:

	% ./configure
	% make
	% make install

this should build cripple and copy it to /usr/local/bin/cripple.

Try ./configure --help for options to configure.

Most things you might want to configure are in cripple.h (default device,
output path, ripper/encoder options etc.).

If you know you will usually want to use a certain cddb server (e.g. a local
freedb mirror) or a certain proxy, you can set this in cripple.h to save
specifying on the command line.

cripple is only extensively tested on linux and cygwin/win32-NT, but it has
preliminary (untested) support for Solaris, Free/NetBSD and DEC OSF/1.

If you have trouble building then the most likely culpret is the CDROM code, as
this is system specific. Make sure you have up to date system headers,
particularly a CDROM header which should be one of <linux/cdrom.h>,
<sys/cdio.h>, <io/cam/cdrom.h>, <w32api/ddk/ntddcdrm.h> (ussually these would
be under /usr/include).

If your system headers are screwed then you can try setting CPPFLAGS=-Iinclude
for configure, but it would be better to fix your headers!

Ripper notes:
-------------

If you are using a SCSI CDROM (or an ATAPI drive with SCSI host adapter
emulation), you will need access to the corresponding scsi-generic device file
(ussually /dev/sg0 on linux). This is the same problem as for CD-writing. A
common and relatively safe way to do this if your CD drive is the only SCSI
device is to make the corresponding sg device owned by group 'cdwriter' with
660 permisions, and add users to that group or make your rippers/writers SGID.

alternatively on Linux cdda2wav will work using generic cdrom ioctl interface
so you don't need access to sg devices, but this is less efficient.

