-----------------------------------------------------------------------
     Update to hai to support CD-ROM
----------------------------------------------------------------------

     This is the alpha update to hai to support CD-ROM drives
enhancements include:

     * Support for SCSI CD-ROM
     * Larger tape drive caches in physical memory.

Notes: Coherent Device Driver Kit users read the Warning at the
bottom of this file.

To install this kit you need to do the following.

     The following files will be modified. If you don't trust me,
(and you shouldn't) save them now:

     /etc/conf/hai/Driver.a
     /etc/conf/hai/Space.c
     /etc/conf/hai/mkdev
     /usr/lib/shell_lib.sh
     /etc/conf/bin/conf_lib.sh

Furthermore, you will be modifying the file:

     /etc/conf/mtune

Directly with your favorite editor. 


1.   As user, root, from the directory /, untar the archive
hai.tar from this directory:

     # gtar xvf (wherever you have hai.tar)/hai.tar

This updates the files in the list above.

2.   With your favorite editor paste following lines into the
file: /etc/conf/mtune:

----- Cut here -------------------------------------------------------
# Tunable cache size for SCSI tape drives. Bigger or smaller tape
# drive caches may enhance your performance. Try this both ways.
# Default of 128k should be adequate for most situations.

HAI_TAPE_CACHE      0    131072    262144
----- Cut here -------------------------------------------------------

3.   If you are using SCSI tape then change the tunable variable
PHYS_MEM_SPEC to reflect the size of the tape drive cache. As
root, from the /etc/conf directory:

     # bin/idtune PHYS_MEM_SPEC 131072

If you have another device that uses memory from the Physical
memory pool then you will need to add that requirement to
whatever you chose to use for tape. For example If you have the
floppy tape driver and are using 256k (262144) bytes for the
floppy tape cache then you will need to add the SCSI tape cache
size (131072) to the current Physical memory size (262144) to
come up with 393216 which you should use for PHYS_MEM_SPEC.

3.   As root, from the /etc/conf/hai directory, run the new mkdev
script to create the proper device nodes. 

     # cd /etc/conf/hai
     # mkdev

Answer all the questions given for your system. If your system
currently works then you can use the defaults for the Disk and
Tape devices and you just need to add CD-ROM devices.

4.   As root, from the /etc/conf directory, make a new kernel
with the command:

     # bin/idmkcoh -o /coh.cdrom

The new kernel will be called /coh.cdrom (change this if you
like).

5.   Reboot your system and after the boot prompt stop the
bootstrap process with the Space bar. then specify the kernel
that you wish to boot:

     ? coh.cdrom

You may type "dir" here to see a list of kernels that are in your
root directory.

6.   Enjoy the CD-ROM programs provided. :-)

----- Warnings, Notes, Etc. ------------------------------------------

o    If you have installed the Coherent Device Driver Kit this
     kit invalidates the source code in the /etc/conf/hai/src
     directory. The idmkcoh process will however destroy the new
     sources so you should move them somewhere else before you
     start this process. 

o    Some devices which require physical memory require this
     memory to be aligned DMA purposes. Depending on which Major
     device they are the may see changes in the start address of
     their memory which affects the alignment of this memory. The
     only way to fix this problem is to tune the PHYS_MEM_SPEC
     larger until these devices see enough memory with the proper
     alignment. 

----- Warnings, Notes, Etc. ------------------------------------------
     
