.\" LICENSE.\".\" This software program is released under the terms of a license agreement between you ('Licensee') and Intel.  Do not use or load this software or any associated materials (collectively, the 'Software') until you have carefully read the full terms and conditions of the LICENSE located in this software package.  By loading or using the Software, you agree to the terms of this Agreement.  If you do not agree with the terms of this Agreement, do not install or use the Software..\".\" * Other names and brands may be claimed as the property of others..\".TH e1000e 1 "May 29, 2008".SH NAMEe1000e \-This file describes the Linux* Base Driver for the Gigabit Family of Adapters..SH SYNOPSIS.PD 0.4vmodprobe e1000e [<option>=<VAL1>,<VAL2>,...].PD 1v.SH DESCRIPTIONThis driver is intended for \fB2.4.x\fR and \fB2.6.x\fR kernels.  This driver includes support for Intel(R) Itanium(R)2-based systems..LPThis driver is only supported as a loadable module at this time.  Intel is not supplying patches against the kernel source to allow for static linking of the driver.  For questions related to hardware requirements, refer to the documentation supplied with your Intel adapter.  All hardware requirements listed apply to use with Linux..SH OPTIONSThe following optional parameters are used by entering them on the command line with the modprobe command.  .LP.B InterruptThrottleRate.IP.B Valid Range: 0,1,3,100-100000 (0=off, 1=dynamic, 3=dynamic conservative).IP.B Default Value: 3.IPThis represents the maximum number of interrupts per second the controller generates.  InterruptThrottleRate is another setting used in interrupt moderation.  Dynamic mode uses a heuristic algorithm to adjust InterruptThrottleRate based on the current traffic load..IPThe default setting is configured to optimize interrupts for bulk throughput while keeping CPU utilization low.  However this setting may result in slower overall transfer speeds if network traffic consists mostly of small packets.  If this is the case, change this value to 0. .IP.B NOTE: InterruptThrottleRate takes precedence over the TxAbsIntDelay and RxAbsIntDelay parameters.  In other words, minimizing the receive and/or transmit absolute delays does not force the controller to generate more interrupts than what the Interrupt Throttle Rate allows..IPSee the section "InterruptThrottleRate" in Readme..LP.B RxIntDelay.IP.B Valid Range: 0-65535 (0=off).br.B Default Value: 0.IPThis sets the delay of the generation of receive interrupts, in units of 1.024 microseconds.  Receive interrupt reduction can improve CPU efficiency if properly tuned for specific network traffic.  Increasing this value adds extra latency to frame reception and can end up decreasing the throughput of TCP traffic.  If the system is reporting dropped receives, this value may be set too high, causing the driver to run out of available receive descriptors..IPCAUTION: When setting RxIntDelay to a value other than 0, adapters may hang (stop transmitting) under certain network conditions.  If this occurs a NETDEV WATCHDOG message is logged in the system event log.  In addition, the controller is automatically reset, restoring the network connection.  To eliminate the potential for the hang ensure that RxIntDelay is set to zero..LP.B RxAbsIntDelay .IP.B Valid Range: 0-65535 (0=off).br.B Default Value: 128.IPThis limits the delay in which a receive interrupt is generated (in units of 1.024 microseconds).  Useful only if RxIntDelay is non-zero, this value ensures that an interrupt is generated after the initial packet is received within the set amount of time.  Proper tuning, along with RxIntDelay, may improve traffic throughput in specific network conditions..LP.B TxIntDelay.IP.B Valid Range: 0-65535 (0=off).br.B Default Value: 64.IPThis sets the delay of the generation of transmit interrupts, in units of 1.024 microseconds.  Transmit interrupt reduction can improve CPU efficiency if properly tuned for specific network traffic.  If the system is reporting dropped transmits, this value may be set too high causing the driver to run out of available transmit descriptors..LP.B TxAbsIntDelay .IP.B Valid Range: 0-65535 (0=off).br.B Default Value: 64.IPThis limits the delay in which a transmit interrupt is generated (in units of 1.024 microseconds).  Useful only if TxIntDelay is non-zero, this value ensures that an interrupt is generated after the initial packet is sent on the wire within the set amount of time.  Proper tuning, along with TxIntDelay, may improve traffic throughput in specific network conditions..LP.B Copybreak.IP.B Valid Range:   0-xxxxxxx (0=off).br.B Default Value: 256.IP.B Usage: insmod e1000e.ko copybreak=128.IPDriver copies all packets below or equaling this size to a fresh rx buffer before handing it up the stack..IPThis parameter is different than other parameters, in that it is a single (not 1,1,1 etc.) parameter applied to all driver instances and it is also available during runtime at /sys/module/e1000e/parameters/copybreak.LP.B SmartPowerDownEnable.IP.B Valid Range: 0-1.br.B Default Value: 1 (uses EEPROM settings); 0 (disabled for 82571EB and 82572-based network connections) .IPAllows Phy to turn off in lower power states. The user can turn off this parameter in supported chipsets..LP.B KumeranLockLoss.IP.B Valid Range: 0-1.br.B Default Value: 1 (enabled).IPThis workaround skips resetting the Phy at shutdown for the initial silicon releases of ICH8 systems..LP.B IntMode.IP.B Valid Range: 0-2 (0=legacy, 1=MSI, 2=MSI-X).br.B Default Value: 2 (MSI-X).IPAllows changing the interrupt mode at module load time, without requiring arecompile. If the driver load fails to enable a specific interrupt mode, thedriver will try other interrupt modes, from least to most compatible.  The interrupt order is MSI-X, MSI, Legacy.  If specifying MSI (IntMode=1) interrupts, only MSI and Legacy will be attempted..LP.SH JUMBO FRAMES.LPJumbo Frames support is enabled by changing the MTU to a value larger than the default of 1500.  Use the ifconfig command to increase the MTU size.  For example:.IPifconfig ethx mtu 9000 up.LP.B NOTE: Jumbo Frames are supported at 1000 Mbps only.  Using Jumbo Frames at 10 or 100 Mbps may result in poor performance or loss of link..LPThe maximum MTU setting for Jumbo Frames is 9216.  This value coincides with the maximum Jumbo Frames size of 9234 bytes..LPAdapters based on the Intel(R) 82573V/E controllers do not support Jumbo Frames..LPSee the section "Jumbo Frames" in Readme..LP.SH Ethtool.LPThe driver utilizes the ethtool interface for driver configuration and diagnostics, as well as displaying statistical information.  Ethtool version 3 or later is required for this functionality, although we strongly recommend downloading the latest version at: http://sourceforge.net/projects/gkernel..LP.SH SPEED AND DUPLEX SETTINGS.LPSpeed and Duplex are configured through the Ethtool* utility.  Ethtool is included with all versions of Red Hat after Red Hat7.2.  For other Linux distributions, download and install Ethtool from the following website: http://sourceforge.net/projects/gkernel.  .LP.SH NAPI.LPNAPI (Rx polling mode) is supported in the e1000e driver.  NAPI is enabled by default. .LPTo disable NAPI, compile the driver module, passing in a configuration option:.IPmake CFLAGS_EXTRA=-DE1000E_NO_NAPI install.LPSee www.cyberus.ca/~hadi/usenix-paper.tgz for more information on NAPI..LP.SH SUPPORT.LPFor additional information, including supported adapters, building, and installation, see the Readme file included with the driver..LPFor general information, go to the Intel support website at:.IP.B http://support.intel.com.LP