SK(4)                     OpenBSD Programmer's Manual                    SK(4)

NAME
     sk - SysKonnect SK-984x PCI Gigabit Ethernet driver

SYNOPSIS
     skc* at pci? dev ? function ?
     sk* at skc?

DESCRIPTION
     The sk driver provides support for the SysKonnect SK-984x series PCI Gi-
     gabit Ethernet adapters, including the following:

           o   SK-9821 SK-NET GE-T single port, copper adapter
           o   SK-9822 SK-NET GE-T dual port, copper adapter
           o   SK-9841 SK-NET GE-LX single port, single mode fiber adapter
           o   SK-9842 SK-NET GE-SX single port, multimode fiber adapter
           o   SK-9843 SK-NET GE-LX dual port, single mode fiber adapter
           o   SK-9844 SK-NET GE-SX dual port, multimode fiber adapter

     The SysKonnect adapters consist of two main components: the XaQti Corp.
     XMAC II Gigabit MAC (sk) and the SysKonnect GEnesis controller ASIC
     (skc).  The XMAC provides the Gigabit MAC and PHY support while the GEne-
     sis provides an interface to the PCI bus, DMA support, packet buffering
     and arbitration. The GEnesis can control up to two XMACs simultaneously,
     allowing dual-port NIC configurations.

     The sk driver configures dual port SysKonnect adapters such that each
     XMAC is treated as a separate logical network interface. Both ports can
     operate independently of each other and can be connected to separate net-
     works. The SysKonnect driver software currently only uses the second port
     on dual port adapters for failover purposes: if the link on the primary
     port fails, the SysKonnect driver will automatically switch traffic onto
     the second port.

     The XaQti XMAC II supports full and half duplex operation with autonego-
     tiation. The XMAC also supports unlimited frame sizes.  Support for jumbo
     frames is provided via the interface MTU setting.  Selecting an MTU larg-
     er than 1500 bytes with the ifconfig(8) utility configures the adapter to
     receive and transmit jumbo frames.  Using jumbo frames can greatly im-
     prove performance for certain tasks, such as file transfers and data
     streaming.

     The following media types and options (as given to ifconfig(8)) are sup-
     ported:

           media autoselect
                Enable autoselection of the media type and options.  The user
                can manually override the autoselected mode by adding media
                options to the appropriate /etc/hostname.skX file.

           media 1000baseSX mediaopt full-duplex
                Set 1000Mbps (Gigabit Ethernet) operation on fiber and force
                full-duplex mode.

           media 1000baseSX mediaopt half-duplex
                Set 1000Mbps (Gigabit Ethernet) operation on fiber and force
                full-duplex mode.

           media 1000baseT mediaopt
                Set 1000Mbps (Gigabit Ethernet) operation and force full-du-
                plex mode.

     For more information on configuring this device, see ifconfig(8). To view
     a list of media types and options supported by your card try ifconfig -m
     <device>. For example, ifconfig -m sk0.

DIAGNOSTICS
     sk%d: couldn't map memory  A fatal initialization error has occurred.

     sk%d: couldn't map ports  A fatal initialization error has occurred.

     sk%d: couldn't map interrupt  A fatal initialization error has occurred.

     sk%d: failed to enable memory mapping!  The driver failed to initialize
     PCI shared memory mapping. This might happen if the card is not in a bus-
     master slot.

     sk%d: no memory for jumbo buffers!  The driver failed to allocate memory
     for jumbo frames during initialization.

     sk%d: watchdog timeout  The device has stopped responding to the network,
     or there is a problem with the network connection (cable).

SEE ALSO
     ifmedia(4), ifconfig(8)

     XaQti XMAC II datasheet, http://www.xaqti.com.

     SysKonnect GEnesis programming manual, http://www.syskonnect.com.

HISTORY
     The sk device driver first appeared in FreeBSD 3.0, and OpenBSD support
     was added in OpenBSD 2.6.

AUTHORS
     The sk driver was written by Bill Paul <wpaul@ctr.columbia.edu>.

OpenBSD 2.9                      July 3, 1999                                2
