-------------------------------------------------------------------------------
Interphase Corp. - E/FDDI 4811 SeaHawk - RMF - Document No. UGRMF16-000, Rev.K


  RRRR   EEEEE    A    DDDD    M   M  EEEEE   FFFFF  I  RRRR    SSS   TTTTT
  R   R  E       A A   D   D   MM MM  E       F      I  R   R  S   S    T
  RRRR   EEE    A   A  D   D   M M M  EEE     FFF    I  RRRR    S       T
  R R    E      AAAAA  D   D   M   M  E       F      I  R R       S     T
  R  R   E      A   A  D   D   M   M  E       F      I  R  R   S   S    T
  R   R  EEEEE  A   A  DDDD    M   M  EEEEE   F      I  R   R   SSS     T




                       HP-UX 10.0 4811 DRIVER R1.8


   
   This document contains Application Notes, Installation Notes, 
   Corrections, and Deficiencies of the Interphase HP-UX 10.x 4811 
   Driver R1.7 for HP 9000 Series 700 computers.  
   
   
   Part Numbers:  SM00002-A08 DDS tape distribution
   	        	  SX00076-A08 media independent image
   
   
   Application Notes:
   ------------------
   
   This release of the 4811 SeaHawk driver is intended for use with
   HP-UX 10.00, 10.01, 10.10, 10.20.  It is also safe to use on 
   multi-processor systems.
   
   This release supports FDDI Station Management (SMT) version 6.2 and
   version 7.3. 
   The minimum version of the SMT 6.2 firmware required to work with this
   driver is FA00073-A04 and FB00073-A04.
   The minimum version of the SMT 7.3 firmware required to work with this
   driver is FA00074-A04 and FB00074-A04.
   
   This software release supports a maximum of three (3) 4811 SeaHawk 
   EISA adapter card per system.
   
   The following HP 9000 Series hardware models are supported by 
   this release:
   
   	700 Series Workstations w/EISA
	C Class Workstations w/EISA
	D Class Server w/EISA
	J Class Workstation w/EISA 
   
   Installation Notes:
   -------------------
   
   This driver may be installed over a previous release. It is not
   necessary to remove the old version.

   To install the Seahawk 4811 driver, run 'swinstall'.  When viewing the 
   products on the tape, the Interphase product will appear as the name 
   "Seahawk_Driver" with the information field reading "Interphase E/FDDI 
   Seahawk 4811 Software Distribution".

   When the install script is completed, it will build a new kernel and reboot
   the system.  After rebooting, it will be necessary to configure the card for
   operation via the SAM program.  Once this is done, the Seahawk board will be
   automatically configured each time the system is rebooted.

   The install script will also create a file called /sbin/init.d/seahawk
   which will create the necessary character special device files upon bootup
   if the Seahawk board is configured up.  These files are necessary only to
   run the provided utilities (i.e. fddimon).

   If you wish to remove the Seahawk software from the system, it is necessary
   to remove the driver from the system using SAM before running 'swremove' to
   uninstall the software.

   There are two versions of the fddimon utility, one that supports SMT 6.23,
   and one that supports SMT 7.3.  They are called fddimon6 and fddimon7
   respectively.  Both are installed into /usr/bin.  For your convenience,
   you may wish to link the appropriate version to 'fddimon'.

   This release includes a snmp subagent called seahagt installed in /usr/sbin.
   This subagent is compatible only with HP-UX 10.01 and above.  The subagent
   is not compatible with HP-UX 10.00. The subagent is designed to work with
   the firmware supporting SMT 7.3.  The minimum version of the 
   SMT 7.3 firmware required to work with this driver is FA00074-A04 
   and FB00074-A04. The subagent will not work with SMT 6.2.
   In order to start the subagent at system boot time add the following
   line to the end of the /etc/inittab file:

      seag:4:wait:/usr/sbin/seahagt                    # seahawk snmp subagent

   The subagent may be manually started by entering: /usr/sbin/seahagt at
   the command line prompt.

   Corrections/upgrades:
   ---------------------
 
   The corrections listed below describe changes made to the driver since
   released version R1.7 (SM00002-A07).

   Symptom : Hewlett Packard Lanadmin reset function would fail, leaving
            the board unable to transmit or receive packets.
 
   Cause   : There were two problems leading to the failure of lanadmin
            reset.
              If the driver was transmitting at the time a reset was
            issued, the FSI transmits rings would continue to fill with
            transmit descriptors. The reset would be delayed, and upon
            completion, the rings would be full and the transmit side
            locked.
             If the driver was replenishing receive descriptors during
            a reset, a timing window existed where the driver could
            loose track of the correct number of oustanding descriptors,
            which resulted in a host memory leak and a system hang.
 
   Solution: The driver has been modified such that all packet transmits
            and memory replenishments are halted during a reset.
 
  
   Symptom : During a reboot of the system, an early panic could occur
            as the driver attempted to pass packets to the protocol
            layer of the system.
 
   Cause   : The driver improperly checked the status of the ifnet
            queue, used to pass IP packets to the system, without
            first ensuring that the protocol layer was ready to
            accept packets. In such a case the ifnet queue would
            be undefined, thus an attempt by the driver to obtain it's
            status would cause a panic of the system.
 
   Solution: A check of the protocol layer's status was implemented,
            such that a possible early reference of queue is eliminated.
 
 
   Symptom : Failure of DLPI SAP binding and unbinding.
 
   Cause   : The driver incorrectly evaluated only the first byte of the
            SAP value rather than all 5 bytes present.
 
   Solution: The portion of code was modified to correctly check all 5
            bytes of the SAP value.
 
 
   Symptom : Netstat reported a number of seahawk transmit errors, that
            were not reported by diagnostic tools(seahmon) included within
            the driver package.
 
   Cause   : A portion of the code was located in which the seahmon counters were
            not properly incremented, thus explaining the difference between
            the two reporting tools.
 
   Solution: Adjusted counters to reflect true board status.
 
 

   
 
   Deficiencies:
   --------------
   
   The following are known problems with this release:

   None known. 

