rtls(7D)							      Devices								  rtls(7D)

NAME

       rtls - 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 support, 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:

	 o  Maximum SDU is 1500 (ETHERMTU).

	 o  Minimum SDU is 0. The driver pads to the mandatory 60-octet minimum packet size.

	 o  The dlsap address length is 8.

	 o  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  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:

	 o  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 controlled 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.

FILES

       rtls

	   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 ALSO

       attributes(5), dlpi(7P), gld(7D)

SunOS 5.10							    28 May 2004 							  rtls(7D)