Devices igb(7D)
NAME
igb - Intel 82575 1Gb PCI Express NIC Driver
SYNOPSIS
/dev/igb*
DESCRIPTION
The igb Gigabit Ethernet driver is a multi-threaded, load-
able, clonable, GLD-based STREAMS driver supporting the Data
Link Provider Interface, dlpi(7P), on Intel 82575 Gigabit
Ethernet controllers.
The igb driver functions include controller initialization,
frame transmit and receive, promiscuous and multicast sup-
port, and error recovery and reporting.
The igb driver and hardware support auto-negotiation, a pro-
tocol specified by the 1000 Base-T standard. Auto-
negotiation allows each device to advertise its capabilities
and discover those of its peer (link partner). The highest
common denominator supported by both link partners is
automatically selected, yielding the greatest available
throughput, while requiring no manual configuration. The igb
driver also allows you to configure the advertised capabili-
ties to less than the maximum (where the full speed of the
interface is not required), or to force a specific mode of
operation, irrespective of the link partner's advertised
capabilities.
APLICATION PROGRAMING INTERFACE
The cloning character-special device, /dev/igb, is used to
access all Intel 82575 Gigabit devices installed within the
system.
The igb driver is managed by the dladm(1M) command line
utility, which allows VLANs to be defined on top of igb
instances and for igb instances to be aggregated. See
dladm(1M) for more details.
You must send an explicit DLATACHREQ message to associate
the opened stream with a particular device (PA). The PA ID
is interpreted as an unsigned integer data type and indi-
cates the corresponding device instance (unit) number. The
driver returns an error (DLERORACK) if the PA 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.
SunOS 5.11 Last change: 20 Jul 2007 1
Devices igb(7D)
The values returned by the driver in the DLINFOACK primi-
tive in response to your DLINFOREQ are:
o Maximum SDU is 9000.
o Minimum SDU is 0.
o DLSAP address length is 8.
o MAC type is DLETHER.
o SAP (Service Access Point) 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 the Ethernet/IE broad-
cast address (F:F:F:F:F:F).
Once in the DLATACHED state, you must send a
DLBINDREQ to associate a particular SAP with the
stream.
CONFIGURATION
By default, the igb driver performs auto-negotiation to
select the link speed and mode. Link speed and mode can be
any one of the following, (as described in the IE803.2
standard):
1000 Mbps, full-duplex.
100 Mbps, full-duplex.
100 Mbps, half-duplex.
10 Mbps, full-duplex.
10 Mbps, half-duplex.
The auto-negotiation protocol automatically selects speed
(1000 Mbps, 100 Mbps, or 10 Mbps) and operation mode (full-
duplex or half-duplex) as the highest common denominator
supported by both link partners.
SunOS 5.11 Last change: 20 Jul 2007 2
Devices igb(7D)
Alternatively, you can set the capabilities advertised by
the igb device using ndd(1M). The driver supports a number
of parameters whose names begin with adv (see below). Each
of these parameters contains a boolean value that determines
if the device advertises that mode of operation. For exam-
ple, the adv1000fdxcap parameter indicates if 1000M full
duplex is advertised to link partner. The advautoneg cap
parameter controls whether auto-negotiation is performed. If
advautonegcap is set to 0, the driver forces the mode of
operation selected by the first non-zero parameter in
priority order as shown below:
(highest priority/greatest throughput)
adv1000fdxcap 1000Mbps full duplex
adv100fdxcap 100Mpbs full duplex
adv100hdxcap 100Mbps half duplex
adv10fdxcap 10Mpbs full duplex
adv10hdxcap 10Mpbs half duplex
(lowest priority/least throughput)
All capabilities default to enabled. Note that changing any
capability parameter causes the link to go down while the
link partners renegotiate the link speed/duplex using the
newly changed capabilities.
FILES
/dev/igb* Special character device.
/kernel/drv/igb 32-bit device driver (x86).
/kernel/drv/amd64/igb 64-bit device driver (x86).
/kernel/drv/sparcv9/igb 64-bit device driver (SPARC).
/kernel/drv/igb.conf Configuration file.
SEE ALSO
dladm(1M), ndd(1M), netstat(1M), driver.conf(4), attri-
butes(5), streamio(7I), dlpi(7P),
Writing Device Drivers
SunOS 5.11 Last change: 20 Jul 2007 3
Devices igb(7D)
STREAMS Programming Guide
Network Interfaces Programmer's Guide
SunOS 5.11 Last change: 20 Jul 2007 4
|
