e1000g(7D)

NAME | SYNOPSIS | DESCRIPTION | APPLICATION PROGRAMMING INTERFACE | CONFIGURATION | FILES | ATTRIBUTES | SEE ALSO

NAME

e1000g– Intel Gigabit, 82542, 82543, 82544, 82540 based network interface controllers

SYNOPSIS

/dev/e1000g 

DESCRIPTION

The e1000g Ethernet driver is a multithreaded, loadable, clonable, STREAMS hardware driver supporting the connectionless Data Link Provider Interface, dlpi(7P), over Intel Gigabit controllers. Multiple Intel Gigabit controllers installed within the system are supported by the driver. The e1000g driver provides basic support for the Intel Gigabit controllers. Functions include chip initialization, frame transmit and receive, multicast support, and error recovery and reporting.

APPLICATION PROGRAMMING INTERFACE

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

e1000g and DLPI

The e1000g driver is a self-sufficient DLPI module that provides all the LAN driver and STREAMS functionality; the /kernel/misc/gld module is not required.

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:

• The maximum SDU (with jumbo frame) is 16128 (ETHERMTU).

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

• The dlsap address length is 8.

• The MAC type is DL_ETHER.

• The sap length value is -2, meaning the physical address component is followed immediately by a 2-byte sap component within the DLSAP address.

• The broadcast address value is Ethernet/IEEE broadcast address (FF:FF:FF:FF:FF:FF).

CONFIGURATION

The e1000g driver does not support the use of shared RAM on the board.

To configure the e1000g driver:

• Use prtconf -v | grep pci8086,[12][01][01][0-F] to obtain the instance number of the driver.

• Use ifconfig e1000ginstance plumb to plumb the controller.

• Use ifconfig e1000ginstance inet ip_address netmask + broadcast + -trailers up to bring up the interface.

• Use the ping(1M) command to contact interfaces on the network to verify that the configuration is operational.

Configuration File Options

The following e100g.conf configuration options are supported:

AutoNegAdvertised

This is a bitmap for the speeds advertised during autonegotiation.

Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 Setting| N/A | N/A | 1000F | N/A | 100F | 100H | 10F | 10H

The adapter only autonegotiates to a speed which is advertised. For example: AutoNegAdvertised = 4 causes an adapter to only advertise autonegotiation at 100 Mbps, full duplex. No other link speeds is accepted or given during autonegotiation. AutoNegAdvertised=47 advertises all speeds available, This is the same as using the default setting of 0.

0–255

Allowed values

0

Default

DmaFairness

When enabled, direct memory access by the driver is fair, meaning transmit and receive have equal priority. When disabled, receive takes priority over transmit.

The allowed values are:

0

Disable.

1

Enable.This is the default.

FlowControl

Flow control utilizes ethernet XON and unicast and multicast XOFF packets to allow ethernet equipment to slow down the stream of data between two ethernet devices.

The allowed values are:

0

Disable. Packets can get dropped in high throughput situations, leading to reduced network performance.

1

Receive only.

2

Transmit only.

3

Receive and transmit. This is the default.

4

Use adapter's EEPROM-programmed factory default setting.

ForceSpeedDuplex

Specify the speed and duplex mode for each instance.

If you set ForceSpeedDuplex=7,4, the e1000g0 is set to autonegotiate and e1000g1 is set to 100 Mbps, full duplex.

Fiber optic ethernet adapters ignore this setting.

The allowed values are:

1

10 Megabits per second, Half Duplex.

2

10 Megabits per second, Full Duplex.

3

100 Megabits per second, Half Duplex.

4

100 Megabits per second, Full Duplex.

7

Autonegotiate speed and duplex.This is the default.

MaxFrags

Maximum number of STREAMS memory buffer fragmentation of incoming or outgoing packets. This value can effect the performance and memory requirements of the driver.

2–8

Allowed values

8

Default

MaxFrameSize

Upper limit on the maximum MTU size the driver allows. All Intel gigabit adapters, except the 82542-based Intel PRO/1000 adapter, allow the configuration of jumbo frames.

The maximum MTU accepted by the MAC is 16128. Use ifconfig(1M) To configure jumbo frames. ifconfig with the adapter instance and the mtu argument (ifconfig e1000g0 mtu 16128) configures adapter e1000g0 for the maximum allowable jumbo frame size.

The allowed values are:

0

Standard ethernet frames with a MTU equal to 1500. This is the default.

1

Jumbo frames with a maximum MTU of 4096.

2

Jumbo frames with a maximum MTU of 8192.

3

Jumbo frames with a maximum MTU of 16384.

MaxFreeListBuf

Maximum number or pre-allocated buffers the driver can use for received data. Pre-allocating buffers can help with receive performance. It also increases the memory requirements of the driver.

0–4096

Allowed values

256

Default

MaxNumReceivePackets

Maximum number of receive packets that the driver can handle for each interrupt.

CPU utilization can be lowered through more effecient interrupt management. If this value is increased, the time needed by the CPU to process the individual interrupts can increase and nullify any performance gains realized by handling less interrupts.

16–1024

Allowed values

32

Default

MWIEnable

x86 Architecture servers based on the Intel 450NX chipset are known to have problems with Memory Write and Invalidate. Disable this feature only for this chipset.

The allowed values are:

0

Disable. This is the default.

1

Enable.

NumRxDescriptors

Number of receive descriptors available to the driver. More receive descriptors increase receive performance at the penalty of decreased available memory.

If you set this value to 256 on Solaris 7 when multiple Intel Gigabit NICs are configured, it causes memory allocation problems. It is recommended that you set this value lower when using multiple Intel Gigabit adapters on Solaris 7.

80–256

Allowed values

256

Default

NumTxDescriptors

Number of transmit descriptors available to the driver. More transmit descriptors increase transmit performance at the penalty of decreased available memory.

If you set this value to 256 on Solaris 7 when multiple Intel Gigabit NICs are configured, it causes memory allocation problems. It is recommended that you set this value lower when using multiple Intel Gigabit adapters on Solaris 7.

80–256

Allowed values

256

Default

ProfileJumboTraffic

If you need to collect statistics on jumbo frame usage, enabling this parameter causes the e1000g driver to keep a count of the number of jumbo frames transmitted and received. Use the netstat -k command to view jumbo frame utilization statistics. See netstat(1M)

The allowed values are:

0

Disable. This is the default.

1

Enable.

TbiCompatibilityEnable=1;

You must enable this feature on Intel 82543CG-based copper adapters to operate correctly with TBI mode ethernet hardware.

The allowed values are:

0

Disable.

1

Enable. This is the default.

TxInterruptDelay

Amount of time (in 1.024 micro second units) between the time transmit data is queued in a transmit descriptor and the transmit interrupt is sent.

0–65535

Allowed values. A value of 0 completely disables any transmit interrupt delay. Some delay is benefical in reducing CPU utilization by the driver.

300

Default.

FILES

/dev/e1000g

e1000g

Character special device

/kernel/drv/e1000g.conf

Configuration file of e1000g driver

sys/stropts.h

stropts network header file

sys/ethernet.h

Ethernet network header file

sys/dlpi.h

dlpi network header file

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Architecture	x86

SEE ALSO

ifconfig(1M), netstat(1M), ping(1M), attributes(5), dlpi(7P)

Intel PRO/1000 Gigabit Adapter Driver Installation Notes for Solaris

SunOS 5.9  Last Revised 5 May 2003

NAME | SYNOPSIS | DESCRIPTION | APPLICATION PROGRAMMING INTERFACE | CONFIGURATION | FILES | ATTRIBUTES | SEE ALSO