****************************************************************************

      Linux alpha driver for PowerCrypt 7751-based board - release 1

****************************************************************************

About files in the package
==========================

This release consists of:

    an LKM driver that provides user mode interface to the 7751 services,

    header files that define user mode interfaces to the driver,

    a console test program that uses the header files and the driver.


Driver build and load procedures
--------------------------------

1. Files placement
------------------

The files can be placed anywhere you like, as long as all the directories 
are together. You don't need the two NT-specfic directories if you're
compiling for Linux or BSD. 

2. Driver building
------------------

Just type "make", and watch it go. When it's finished, you should have
a file called pcrypt.o in the current directory.

3. Making devnode
-----------------

Enter 'mknod /dev/pcrypt0 55 0'

'pcrypt0' is the name of the device. It is defined in the
pwrcryptioctl.h file and is used by the driver clients to open the device.
If it's desirable to change it, the change must be synchronized with that
header file and client programs.

55 is the driver major number. It is hardcoded into the driver and can't
be changed without rebuilding.

0 is the device minor number. The driver doesn't check it and it generally
can be any number. The driver provides a single service point accessible
through the driver major number.


4. Driver loading
-----------------

Type "insmod pcrypt.o", and it should load and print some diagnostics.
Once it loads, you should be able to see it in lsmod with a reference
count of 0, and in /proc/devices as well. 


5. Driver testing with testio.c
-------------------------------

Copy
    testio.c
    descomm.h
    pwrcryptioctl.h
    instrset.h
        to a directory.

Make that directory current and enter 'cc testio.c'.
The file a.out will be created.
Run a.out.

testio.c opens the device, sends several ioctl requests and then exits.


6. Driver unloading
-------------------

Type "rmmod pcrypt.o" and it should unload cleanly. 


Interfaces
----------

The headers pwrcryptioctl.h (includes instrset.h) define user-mode
IOCTL interface.

descomm.h - is not actually the part of interface, included for illustration
only and is used by the test program.


Test program files
------------------

testio.c opens the device, sends several ioctl requests and then exits.

