Technical data

SunOS 5.5 Devices tr(7D)
NAME tr − IBM 16/4 Token Ring Network Adapter device driver
SYNOPSIS #include <sys/stropts.h>
#include <sys/ethernet.h>
#include <sys/dlpi.h>
AVAILABILITY x86
DESCRIPTION The tr token ring driver is a multi-threaded, loadable, clonable, STREAMS hardware
driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over IBM
16/4 Token Ring adapters. The driver supports installation of both a primary and secon-
dary 16/4 Adapter within the system. The tr driver provides basic support for the IBM
16/4 Adapter hardware. Functions include chip initialization,frame transmit and
receive, functional addresses, and “promiscuous” support, and error recovery and
reporting.
The cloning, character-special device /dev/tr is used to access all 16/4 adapter devices
installed within the system.
The tr 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 indicates 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/tr.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 system. The device is initialized on
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 4084.
The minimum SDU is 0.
The dlsap address length is 7 or 8 bytes.
The MAC type isDL_TPR.
The sap length value is −1 or −2, meaning the physical address component is
followed immediately by a 1 or 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 the IEEE broadcast address (FF:FF:FF:FF:FF:FF).
modified 15 Oct 1993 7D-379