illumos: manual page: dnet.4d

DNET(4D) DNET(4D)

NAME

dnet - Ethernet driver for DEC 21040, 21041, 21140 Ethernet cards

SYNOPSIS

/kernel/drv/dnet

DESCRIPTION

The dnet Ethernet driver is a multithreaded, loadable, clonable, STREAMS
GLD driver. Multiple controllers installed within the system are
supported by the driver. The dnet driver functions include controller
initialization, frame transmit and receive, functional addresses,
promiscuous and multicast support, and error recovery and reporting.

APPLICATION PROGRAMMING INTERFACE

The cloning character-special device, /dev/dnet, is used to access all
DEC 21040/21041/21140 devices installed in the system.

The dnet driver is dependent on /kernel/misc/gld, a loadable kernel
module that provides the dnet driver with the DLPI and STREAMS
functionality required of a LAN driver. See gld(4D) for more details on
the primitives supported by the driver.

The device is initialized on the first attach and de-initialized
(stopped) on the last detach.

The values returned by the driver in the DL_INFO_ACK primitive in
response to a DL_INFO_REQ from the user are as follows:

o The maximum SDU is 1500 (ETHERMTU - defined in
<sys/ethernet.h>).

o The minimum SDU is 0.

o The DLSAP address length is 8.

o The MAC type is DL_ETHER.

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

o The broadcast address value is the Ethernet/IEEE broadcast
address (FF:FF:FF:FF:FF:FF).

Once in the DL_ATTACHED state, the user must send a DL_BIND_REQ to
associate a particular Service Access Point (SAP) with the stream.

PRECONFIGURATION

The PCI configuration process varies from system to system. Follow the
instructions provided by the vendor.

Known Problems and Limitations

o On multiport cards (exception: Osicom (Rockwell) RNS2340), the
first port is the top port. (On the Osicom RNS2340, the first
port is the bottom port.)

o If the dnet driver fails to determine the correct speed and
duplex mode resulting in a corresponding drop in performance,
set the speed and duplex mode using the dnet.conf file.

o The dnet driver incorrectly counts carrier lost or no carrier
errors while in full-duplex mode. There is no carrier signal
present when in full-duplex mode and it should not be counted
as an error.

o Version 4 SROM formats are not supported.

CONFIGURATION

The /kernel/drv/dnet.conf file supports the following options:

full-duplex
For full duplex operation use full-duplex=1, for half
duplex use full-duplex=0. Half-duplex operation gives
better results on older 10mbit networks.

speed
For 10mbit operation use speed=10, for 100mbit operation
use speed=100. Certain 21140 based cards will operate at
either speed. Use the speed property to override the
100mbit default in this case.

FILES

/dev/dnet
character special device

/kernel/drv/dnet.conf
dnet configuration file

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|Architecture | x86 |
+---------------+-----------------+