'\" te
.\" Copyright (c) 2008, 2012, Oracle and/or its affiliates. All rights reserved.
.TH ixgb 7d "5 Jan 2012" "SunOS 5.11" "Devices"
.SH NAME
ixgb \- SUNWixgb, 10 Gigabit  Ethernet driver  for Intel 82597ex controllers and Sun Ethernet PCI-X Adapter (X5544A-4) adapters.
.SH SYNOPSIS
.LP
.nf
\fB/dev/ixgb\fR 
.fi

.SH DESCRIPTION
.sp
.LP
The \fBixgb\fR 10 Gigabit Ethernet  driver is a multi-threaded, loadable, clonable, GLD-based STREAMS driver supporting the Data Link Provider Interface, \fBDLPI\fR on Intel  82597ex  10 Gigabit  Ethernet  controllers and  Sun 10 Gigabit Ethernet PCI-X Adapter (X5544A-4) on  x86 Platforms. The Intel 10G controller  incorporates both  MAC and  PHY  functions and provides 10G (fiber) Ethernet operation on  the  SR and LR connectors.  The Sun 10  Gigabit  Ethernet  PCI-X  Adapter (X5544A-4)  is a 133  MHz  PCI-X 10  Gigabit Ethernet card utilizing  the Intel  82597EX PCI-X  MAC  controller with XFP-based  10GigE optics.
.sp
.LP
The \fBixgb\fR driver functions include controller initialization, frame transmit and receive, promiscuous and multicast support and error recovery and reporting.
.sp
.LP
The \fBixgb\fR driver and hardware support auto-negotiation, a protocol specified by the \fIIEEE 802.3ae\fR specification.
.SH CONFIGURATION
.sp
.LP
The following \fBixgb.conf\fR configuration option is supported:
.sp
.ne 2
.mk
.na
\fBdefault_mtu\fR
.ad
.sp .6
.RS 4n
Upper limit on the maximum MTU size the driver allows. Intel 82597EX controller allows the configuration of jumbo frames. To configure jumbo frame, use \fBifconfig\fR(1M). Use ifconfig with the adapter  instance and the mtu argument (for example: ifconfig ixgb0 mtu 9000) to configure the adapter for the maximum allowable jumbo frame size. Allowed range is 1500 - 9000.
.RE

.SH APPLICATION PROGRAMMING INTERFACE
.sp
.LP
The cloning character-special device /dev/ixgb is used to access all Intel 10G controllers and Sun 10 Gigabit Ethernet PCI-X adapters (X5544A-4) installed within the system
.sp
.LP
The \fBixgb\fR driver is managed by the \fBdladm\fR(1M) command line utility, which allows VLANs to be defined on top of \fBixgb\fR  instances and for \fBixgb\fR instances to be aggregated. See \fBdladm\fR(1M) for more details.
.sp
.LP
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  (\fBDL_ERROR_ACK\fR) 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. 
.sp
.LP
The values returned by the driver in the \fBDL_INFO_ACK\fR primitive in response to the \fBDL_INFO_REQ\fR are:
.RS +4
.TP
.ie t \(bu
.el o
Maximum \fBSDU\fR is \fB9000\fR (\fBETHERMTU\fR, as defined in  \fB<sys/ethernet.h>\fR).
.RE
.RS +4
.TP
.ie t \(bu
.el o
Minimum \fBSDU\fR is \fB0\fR.
.RE
.RS +4
.TP
.ie t \(bu
.el o
\fBDLSAP\fR address length is \fB8.\fR
.RE
.RS +4
.TP
.ie t \(bu
.el o
\fBMAC\fR type is \fBDL_ETHER.\fR
.RE
.RS +4
.TP
.ie t \(bu
.el o
\fBSAP\fR length value is \fB\(mi2\fR meaning the physical address component is followed immediately  by a 2 byte \fBSAP\fR component within the \fBDLSAP\fR address.
.RE
.RS +4
.TP
.ie t \(bu
.el o
Broadcast address value is Ethernet/IEEE broadcast address (\fBFF:FF:FF:FF:FF:FF\fR).
.RE
.sp
.LP
Once in the \fBDL_ATTACHED\fR state, you must send a \fBDL_BIND_REQ\fR to associate a particular Service Access Point (\fBSAP\fR) with the stream.
.sp
.LP
By default, the \fBixgb\fR driver performs auto-negotiation to select the 10G link speed.
.SH FILES
.sp
.ne 2
.mk
.na
\fB\fB/dev/ixgb\fR\fR
.ad
.RS 28n
.rt  
Special character device.
.RE

.sp
.ne 2
.mk
.na
\fB\fB/kernel/drv/sparcv9/ixgb\fR\fR
.ad
.RS 28n
.rt  
Driver binary.
.RE

.sp
.ne 2
.mk
.na
\fB\fB/kernel/drv/amd64/ixgb\fR\fR
.ad
.RS 28n
.rt  
64-bit kernel module (x86 only).
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Architecturex86
.TE

.SH SEE ALSO
.sp
.LP
\fBdladm\fR(1M), \fBifconfig\fR(1M), \fBattributes\fR(5), \fBgld\fR(7D), \fBstreamio\fR(7I), \fBdlpi\fR(7P)
.sp
.LP
\fIIEEE 802.3ae 10 Gigabit Ethernet Specification\fR \(em June, 2002
.sp
.LP
\fISun  10  Gigabit  Ethernet  PCI-X  Adapter (X5544A-4) Driver Installation Notes for Solaris\fR
.sp
.LP
\fIWriting Device Drivers\fR
.sp
.LP
\fISTREAMS Programming Guide\fR
.sp
.LP
\fINetwork Interfaces Programmer's Guide\fR