INSTALL 	INSTALL notes for CDTOOL 2.1
W. Wade, Hampton
7/16/1998

This file needs work....

First, determine if you have a SCSI CD-ROM.  If you do,
use the SCSI options below.  The IOCTLs are in the process
of being standardized in the kernel and there should be 
an update to this program at sometime in the future.
For more information on this standardization effort, see:

  /usr/src/linux/Documentation/cdrom/cdrom-standard.tex
  (should be available with 2.0.x and 2.1.x kernels)

Actually, most users should use "make scsi" as the main
difference is using the MSF IOCTL call versus a call to 
start play by specifying a track (this later IOCTL is not
implemented in the 2.0.x CD-ROM driver).  Testing does
indicate that "make scsi" results in an executable that 
works with both SCSI and IDE CD-ROMS  

If anyone checks this on non-SCSI or non-IDE CD-ROMS and
things work, please e-mail me (whampton@staffnet.com).

(1) Extract the tarball:
	gunzip -cd cdtool-2.1.tar.gz | tar xvf -
    or, with GNU tar:
	tar xvzf cdtool-2.1.tar.gz
    
(2) Edit the config.h and make any changes.

(3) If making for a SCSI CDROM:
	make scsi
	make install
    If making for a non-scsi CDROM:
	make all
	make install

(4) Test out by playing a CD-ROM:
	cdstart
	cdshuffle
	cdctrl
	etc.

(5) Test cdown by first establishing a connection to 
    the Internet, inserting a CD-ROM , then typing 
    cdown [options].  Before testing cdown, you should
    first make sure that cdstart, etc. work and that
    your network connection is up and working (for 
    example, ping www.cddb.com).

If you get an access problem with the CDROM device, you
need to give yourself permission to read and write to 
/dev/cdrom* or whatever name your CD-ROM has.  For example,
as root:
	chmod 666 /dev/hdb    -- IDE CDROM on /dev/hdb
  or
	chmod 666 /dev/scd0   -- SCSI CDROM on /dev/scd0 

For testing, type "make debug" or "make debugscsi".


CDCTRL (WARNING):
=================
If you want to use cdctrl from inetd to have remote control
of your CD-ROM, you can edit /etc/services and /etc/inetd.conf
per the instructions below.  WARNING:  Please note, this code 
may not be secure and could open up security holes on your system.
If anyone is willing to check this please let me know of
any fixes required to close any holes!

(1) Add a CD-ROM to /etc/services with the 9000 being a port
    that you want to use (any one above 1024):

cdrom	9000/tcp	# first CDROM drive

(2) Add a CD-ROM controller to /etc/inetd.conf with anyuser being
    the name of a user who should run the program, /usr/local/bin/cdctrl
    being the name of the program to run, and /dev/cdrom being the
    name of your CD-ROM.

cdrom stream tcp nowait anyuser /usr/sbin/tcpd /usr/local/bin/cdctrl /dev/cdrom