dge(4) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
DGE(4)                  NetBSD Kernel Interfaces Manual                 DGE(4)


NAME

     dge -- Intel i82597EX Ten Gigabit Ethernet driver


SYNOPSIS

     dge* at pci? dev ? function ?


DESCRIPTION

     The dge device driver supports the Intel i82597EX PRO/10GbE LR Ethernet
     adapter, which uses a single mode fiber (1310nm) interface.

     The i82597EX supports IPv4/TCP/UDP checksumming in hardware, as well as
     TCP Segmentation Offloading (TSO).  The driver does currently only sup-
     port the hardware checksumming features.  See ifconfig(8) for information
     on how to enable the hardware checksum calculations.

     The driver also makes use of the ifconfig(8) link flags link0 and link1
     to set the PCIX burst size.  The burst size is set according to this ta-
     ble:

     link0    link1    burst size
     off      off      512
     on       off      1024
     off      on       2048
     on       on       4096

     A larger burst size will increase the transmit capacity of the card dra-
     matically but may have negative effect on other devices in the system.


DIAGNOSTICS

     dge%d: Tx packet consumes too many DMA segments, dropping...  The packet
     consisted of too many small mbufs and could therefore not be loaded into
     a DMA map.  This is most unlikely, the driver can currently handle up to
     100 segments, but over 80 segments has been seen using large (16k) jumbo
     frames.

     dge%s: device timeout (txfree %d txsfree %d txnext %d)  The i82597EX had
     been given packets to send, but didn't interrupt within 5 seconds.  This
     diagnostic is most likely the result of a hardware failure, and the chip
     will be reset to resume normal operation.

     dge%d: Receive overrun  If the computer is under heavy load, the software
     may not be able to keep up removing received datagrams from the receive
     queue, and will therefore loose datagrams.  To avoid this, check that the
     other end is using the XON/XOFF protocol, if possible, or increase the
     receive descriptor ring size in the driver.

     dge%d: symbol error
     dge%d: parity error  An error in the XGMII communication was detected.
     This is a hardware error in the MAC<->PHY communication bus.

     dge%d: CRC error  A CRC error in the received datagram was detected.  The
     error is probably caused in the fiber communication.

     dge%d: WARNING: reset failed to complete  This is a fatal error and means
     that the hardware is broken and will most likely not function correctly.

     dge%d: unable to allocate or map rx buffer %d error = %d  The driver was
     not able to map a mbuf cluster page to a receive descriptor entry in the
     receive ring.  Most likely the system has run out of mbuf clusters or
     have a too small cluster map.  See the errno for more information.


SEE ALSO

     arp(4), ifmedia(4), netintro(4), pci(4), ifconfig(8)


HISTORY

     The dge driver first appeared in NetBSD 2.0.


AUTHORS

     The dge driver was written by Anders Magnusson <ragge@ludd.luth.se>.


BUGS

     There should be an XGMII framework for the driver to use.

NetBSD 7.0                      March 18, 2004                      NetBSD 7.0