rtls(7D) Devices rtls(7D)NAMErtls - Realtek Fast Ethernet 8139-based network interface controllers
SYNOPSIS
/dev/rtls
DESCRIPTION
The rtls Ethernet driver is a multi-threaded, loadable, clonable,
STREAMS hardware driver supporting the connectionless Data Link
Provider Interface, dlpi(7P), over Realtek 8139 controllers. The rtls
driver provides basic support for the Realtek 8139 hardware. Functions
include chip initialization, frame transmit and receive, multicast sup‐
port, and error recovery and reporting.
APPLICATION PROGRAMMING INTERFACE
The cloning, character-special device /dev/rtls is used to access all
8139 devices installed within the system.
rtls and DLPI
The rtls driver is dependent on /kernel/misc/gld, a loadable kernel
module that provides the rtls driver with the DLPI and STREAMS func‐
tionality required of a LAN driver. See gld(7D) for more details on the
primitives supported by the driver.
The values returned by the driver in the DL_INFO_ACK primitive in
response to the DL_INFO_REQ from the user are as follows:
· Maximum SDU is 1500 (ETHERMTU).
· Minimum SDU is 0. The driver pads to the mandatory 60-octet mini‐
mum packet size.
· The dlsap address length is 8.
· MAC type is DL_ETHER.
· The sap length value is −2, meaning the physical address component
is followed immediately by a 2-byte sap component within the DLSAP
address.
· Broadcast address value is Ethernet/IEEE broadcast address
(FF:FF:FF:FF:FF:FF).
KNOWN PROBLEMS AND LIMITATIONS
The rtls driver only supports Realtek 8139 on x86 platforms.
The rtls driver does not support the NDD interface and MII statistics.
Realtek 8139 works under 100FDX/100HDX and 10FDX/10HDX modes, which you
can set using the rtls.conf file.
CONFIGURATION
To configure the rtls driver:
· Use prtconf -v | grep pci10ec,8139 to obtain the instance number
of the driver. (pci1186,1301 or pci1113,1211 indicates a third-
party ethernet device with an 8139 chip that can also be con‐
trolled by the rtls driver.)
The rtls.conf configuration file options include:
-ForceSpeedDuplex
Default: 5 (Auto-negotiate)
Allowed Values: 4 (100 FDX)
3 (100 HDX)
2 (10 FDX)
1 (10 HDX)
Specify the speed and duplex mode for each instance.
Example: ForceSpeedDuplex=5,4;
Sets rtls0 to autonegotiate and rtls1 to 100 FDX.
FILESrtls
Device special file.
/kernel/drv/rtls.conf
rtls configuration file.
<sys/stropts.h>
stropts network header file.
<sys/ethernet.h>
Ethernet network header file.
<sys/dlpi.h>
dlpi network header file.
<sys/gld.h>
gld network header file.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Architecture │x86 │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOattributes(5), dlpi(7P), gld(7D)SunOS 5.10 28 May 2004 rtls(7D)
