skfp(7D)




NAME

     skfp - SysKonnect FDDI PCI device driver


SYNOPSIS

     /dev/skfp


DESCRIPTION

     The skfp FDDI driver is a  multi-threaded,  loadable,  clon-
     able,  STREAMS hardware driver supporting the connectionless
     Data Link Provider Interface (DLPI) over a  SysKonnect  FDDI
     PCI  adapter. The driver supports multiple installed SysKon-
     nect FDDI PCI adapters. Functions include  chip  initializa-
     tion,  frame  transit and receive, multicast and promiscuous
     support, and error recovery and reporting.

     The skfp driver supports  all  SysKonnect  SK-NET  FDDI  PCI
     adapters  (SK-55xx  (32-bit) and SK-58xx (64-bit) series) on
     32-bit systems, and  the SK-58xx series on 64-bit systems.


APPLICATION PROGRAMMING INTERFACE

     The skfp driver provides the  /dev/skfp  cloning  character-
     special  device  that  accesses all SK-NET FDDI PCI adapters
     using Data Link Service (DLS)  Style  2.  It  also  provides
     per-adapter  character-special  devices /dev/skfpx, (where x
     represents the device instance number) that access a special
     NIC using DLS Style 1.

  skfp and DLPI
     The skfp driver is a Style 1 and Style 2  DLS provider.  All
     M_PROTO  and M_PCPROTO type messages are interpreted as DLPI
     primitives.  Valid   DLPI    primitives   are   defined   in
     <sys/dlpi.h>. See dlpi(7P).

     An explicit DL_ATTACH_REQ message by the user is required to
     associate  the opened Stream with a particular device (ppa).
     This is unnecessary and invalid for DLPI Style 1. The ppa ID
     is  interpreted  as an unsigned long data type and indicates
     the corresponding device instance (unit)  number.  An  error
     (DL_ERROR_ACK)  is  returned  by the driver if the ppa field
     value does not correspond to a valid device instance  number
     for the system.

     The device is initialized on first attach and de-initialized
     (stopped)  upon  last  detach.  Valid device numbers for all
     detected adapters are displayed on  the  console  at  driver
     startup time and written to the /var/adm/messages log file.

     The values returned in the DL_INFO_ACK primitive in response
     to the DL_INFO_REQ request are:

        o  Maximum SDU is 4470.

        o  Minimum SDU is 0.

        o  DSLAP address length is 8 bytes.

        o  MAC type is DL_FDDI.

        o   SAP length value is -2, meaning the physical  address
           component is followed immediately by a 2-byte SAP com-
           ponent within the DLSAP address.

        o  Service mode is DL_CLDLS.

        o  Optional quality  of  service  (QOS)  support  is  not
           included; as a result, the QOS field values are 0.

        o  Provider style is DL_STYLE2.

        o  Version is DL_VERSION_2.


OPTIONS

     Options are not required for normal  operation.  In  special
     cases, FDDI Station Management (SMT) parameters can be modi-
     fied by using the /usr/bin/smtpara utility (see  the  driver
     README  files).  The  smtpara utility should be used only by
     those very familiar with FDDI.

 DIAGNOSTICS
     If multiple NICs are installed in the system, the  following
     message   may   appear   on   the   console   and   in   the
     /var/adm/messages log file:

          skfp: DMA memory allocation failed !

     You can avoid this message by tuning the  lomempages  kernel
     parameter.  By  default,  the  value of this parameter is 36
     pages. Each SK-FDDI PCI  adapter  requires  nine  pages,  so
     increase the value of the lomempages parameter in increments
     of nine pages until all NICs in the system run correctly.

     To modify the value of this parameter to 45 pages, you  can,
     for  example,  append  the  set  lomempages=45  line  to the
     /etc/system file and reboot the system.


FILES

     /dev/skfp
           Character special device

     /dev/skfpx
           Per-adapter character special device, where x  is  the
           adapter ppa

     /kernel/drv/skfp
           ELF kernel module

     /kernel/drv/sparcv9/skfpx
           ELF kernel module (64-bit SPARC version)

     /kernel/drv/skfp.conf
           Driver configuration file

     /usr/bin/smtpara
           SMT parameter utility

     /etc/fddi.cfg
           smtpara configuration file

     <sys/dlpi.h>
           DLPI definitions


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Architecture                | IA, SPARC                   |
    |_____________________________|_____________________________|


SEE ALSO

     ifconfig(1M), netstat(1M), attributes(5), dlpi(7P)

     skfp.txt  (32-bit  driver)  and  skfpx.txt  (64-bit  driver)
     README  files  - Included in the driver package or available
     from www.syskonnect.com.


Man(1) output converted with man2html