Technical data

SunOS 5.5 Devices elink(7D)
NAME elink − 3COM 3C507 Ethernet device driver
SYNOPSIS #include <sys/stropts.h>
#include <sys/ethernet.h>
#include <sys/dlpi.h>
AVAILABILITY x86
DESCRIPTION The elink Ethernet driver is a multi-threaded, loadable, clonable,STREAMS hardware
driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over 3COM
3C507 EtherLink 16 Ethernet controllers. Multiple EtherLink 16 controllers installed
within the system are supported by the driver. The elink driver provides basic support
for the EtherLink 16 hardware. Functions include chip initialization,frame transmit and
receive, multicast and “promiscuous” support, and error recovery and reporting.
APPLICATION
PROGRAMMING
INTERFACE
The cloning, character-special device /dev/elink is used to access all EtherLink 16 devices
installed within the system.
elink and DLPI The elink driver is a “style 2” Data Link Service provider. All M_PROTO and
M_PCPROTO type messages are interpreted as DLPI primitives. An explicit
DL_ATTACH_REQ message by the user is required to associate the opened stream with a
particular device (ppa). The ppa ID is interpreted as an unsignedlong integer and indi-
cates the corresponding device instance (unit) number. The unit numbers are assigned
sequentially to each board found. The search order is determined by the order defined in
the /kernel/drv/elink.conf file. 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 this sys-
tem. The device is initializedon first attach and de-initialized (stopped) on last detach.
The values returned by the driver in theDL_INFO_ACK primitive in response to the
DL_INFO_REQ from the user are as follows:
The maximum SDU is 1500 (ETHERMTU).
The minimum SDU is 0. The driver will pad to the mandatory 60-octet
minimum packet size.
The dlsap address length is 8.
The MAC type isDL_ETHER.
The sap length value is −2, meaning the physical address component is fol-
lowed immediately by a 2-byte sap component within the DLSAP address.
The service mode is DL_CLDLS.
No optional quality of service (QOS) support is included at present, so the
QOS fields are 0.
The provider style isDL_STYLE2.
The version isDL_VERSION_2.
The broadcast address value is Ethernet/IEEE broadcast address
modified 2 May 1995 7D-97