xref: /illumos-gate/usr/src/man/man4d/xge.4d (revision 70143b9f)
te
Copyright (c) 2005, Sun Microsystems All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
XGE 4D "Oct 3, 2005"
NAME
xge - Neterion Xframe 10Gigabit Ethernet Network Adapter driver
SYNOPSIS

/dev/xge
DESCRIPTION

The xge 10 Gigabit Ethernet driver is a multi-threaded, loadable, clonable, GLD-based STREAMS driver supporting the Data Link Provider Interface, dlpi(4P), on S2IO Xframe 10-Gigabit Ethernet Network Adapter.

The xge driver functions includes controller initialization, frame transmit and receive, promiscuous and multicast support, TCP and UDP checksum offload (IPv4 and IPv6), 9622-byte jumbo frame, and error recovery and reporting.

The xge driver and hardware support the 10GBase-SR/W, LR/W, and ER/W 802.3 physical layer.

APPLICATION PROGRAMMING INTERFACE

The cloning, character-special device /dev/xge is used to access all Xframe devices installed within the system.

The xge driver is managed by the dladm(8) command line utility, which allows VLANs to be defined on top of xge instances and for xge instances to be aggregated. See dladm(8) for more details.

The values returned by the driver in the DL_INFO_ACK primitive in response to the DL_INFO_REQ are as follows:

Maximum SDU is 9600.

Minimum SDU is 0.

DSLAP address length is 8 bytes.

MAC type is DL_ETHER.

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).

CONFIGURATION

By default, the xge driver works without any configuration file.

You can check the running-time status of a device instance using ndd(8). Currently, the driver provides an interface to print all hardware statistics.

For example, to print statistics of device xge0:

 #ndd /dev/xge0 stats
 tmac_data_octets 772
 tmac_frms 15
 tmac_drop_frms 0
 tmac_bcst_frms 6
 tmac_mcst_frms 6

 ...

 rmac_vld_frms 13
 rmac_fcs_err_frms 0
 rmac_drop_frms 0
 rmac_vld_bcst_frms 7
 rmac_vld_mcst_frms 11
 rmac_out_rng_len_err_frms 0
 rmac_in_rng_len_err_frms 0
 rmac_long_frms 0

 ...

 not_traffic_intr_cnt 242673
 traffic_intr_cnt 28

 ...
FILES
/dev/xge

xge special character device

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Architecture x86
SEE ALSO

streamio (4I), dlpi (4P), attributes (7), dladm (8), ndd (8)

Writing Device Drivers

STREAMS Programming Guide

Network Interfaces Programmer's Guide