rtls(7d) [sunos man page]
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)
Check Out this Related Man Page
ixgb(7d) Devices ixgb(7d) NAME
ixgb - SUNWixgb, 10G Gigabit Ethernet driver for Intel 82597ex controllers and Sun Kirkwood adapters SYNOPSIS
/dev/ixgb DESCRIPTION
The ixgb 10Gigabit Ethernet driver is a multi-threaded, loadable, clonable, GLD-based STREAMS driver supporting the Data Link Provider Interface, DLPI, on Intel 82597ex 10 Gigabit Ethernet controllers and Sun 10G Kirkwood adapters. The Intel 10G controller incorporates both MAC and PHY functions and provides 10G (fiber) Ethernet operation on the SR and LR connectors. The Sun Kirkwood adapter is a 133 MHz PCIX 10 Gig Ethernet card utilizing the Intel 82597EX PCIX MAC controller with XFP-based 10GigE optics. The ixgb driver functions include controller initialization, frame transmit and receive, promiscuous and multicast support and error recov- ery and reporting. The ixgb driver and hardware support auto-negotiation, a protocol specified by the 802.ae specification. APPLICATION PROGRAMMING INTERFACE
The cloning character-special device /dev/ixgb is used to access all Intel 10G controllers and Sun Kirkwood adapters installed within the system. The ixgb driver is dependent on /kernel/misc/gld, a loadable kernel module that provides the ixgb driver with the DLPI and STREAMS func- tionality required of a LAN driver. See gld(7D) for more details on supported primitives. You must send an explicit DL_ATTACH_REQ message to associate the opened stream with a particular device (PPA). The PPA ID is interpreted as an unsigned integer data type and indicates the corresponding device instance (unit) number. The driver returns an error (DL_ERROR_ACK) if the PPA field value does not correspond to a valid device instance number for the system. The device is initialized on first attach and de- initialized (stopped) at last detach. The values returned by the driver in the DL_INFO_ACK primitive in response to the DL_INFO_REQ are as follows: o Maximum SDU is 1500 (ETHERMTU - defined in <sys/ethernet.h>). o Minimum SDU is 0. o DLSAP address length is 8. o MAC type is DL_ETHER. o 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). Once in the DL_ATTACHED state, you must send a DL_BIND_REQ to associate a particular Service Access Point (SAP) with the stream. By default, the ixgb driver performs auto-negotiation to select the 10G link speed. FILES
/dev/ixgb ixgb special character device. /kernel/drv/sparcv9/ixgbixgb driver binary. /kernel/drv/amd64/ixgb 64-bit kernel module (x86 only.) ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Architecture |SPARC, x86 | +-----------------------------+-----------------------------+ SEE ALSO
attributes(5), gld(7D), streamio(7I), dlpi(7P) Writing Device Drivers STREAMS Programming Guide Network Interfaces Programmer's Guide SunOS 5.10 1 Dec 2004 ixgb(7d)