Version 2.0.5 Linux Driver release for IBM Netfinity Gigabit Ethernet SX Adapter ============================================================ The above IBM adapter shares the same Linux driver released by Intel for Intel PRO/1000 Linux driver also apply to IBM Netfinity Gigabit Ethernet SX Adapter. This package includes the source code for a Linux driver for the Intel PRO/1000 Gigabit Server Adapter. This driver is known to build properly on 2.2 and 2.3 series kernels up to 2.2.14 and 2.3.51. All testing by Intel has been performed on Linux 2.2 series kernels on PCs with Intel processors. Kernels prior to 2.2.0 and beyond 2.2.14 are not supported. The bin/e1000.o was built for a 2.2.14 SMP kernel as included in RedHat 6.2. The driver will need to be rebuilt for use with any other kernel. The PRO/1000 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. Please refer to the documentation supplied with your adapter to answer any questions related to hardware requirements. All hardware requirements listed apply to use with Linux. Building and Installation ========================= Note: For the build to work properly it is important that the currently running kernel match the version and configuration of the installed kernel sources. 1) Enter the src directory ('cd src'). The rest of the build process should be run from here. 2) Run 'make' to build the driver as a loadable module. 3) Test the loading of the driver by running 'insmod e1000.o'. 4) Run 'make install' to install the e1000.o binary. The binary will be installed as: /lib/modules/[KERNEL_VERSION]/net/e1000.o Basic Configuration =================== Once the driver has been installed it can be loaded by running 'modprobe e1000'. This will create a new Ethernet device. For example, if no other Ethernet drivers are loaded the PRO/1000 will be called eth0. The interface can be activated and assigned an IP address by running: `ifconfig ethX yyy.yyy.yyy.yyy' where ethX is the Ethernet device and yyy.yyy.yyy.yyy is the IP address. Command Line Configuration ========================== Command line parameters are passed to the driver through the modprobe or insmod utilities. Each parameter will accept arguments for supporting up to eight adapters. For instance, to load the driver with two PRO/1000 adapters in the system and use 128 transmit descriptors and 128 receive descriptors on each adapter the command would be: modprobe e1000 TxDescriptors=128,128 RxDescriptors=128,128 TxDescriptors Valid Range: 8-4096 Default Value: 64 The PRO/1000 uses descriptor-based bus mastering to transfer data to and from host memory. TX Descriptors are used to tell the hardware where the transmit packet is in host memory. Each descriptor is 16 bytes. RxDescriptors Valid Range: 8-4096 Default Value: 64 The PRO/1000 uses descriptor based bus mastering to transfer data to and from host memory. RX descriptors tell the hardware where to DMA reveived packets. For each RX descriptor the driver will also allocate a reveive buffer. Each descritptor is 16 bytes and each buffer is either 2048 bytes or 16384 bytes, depending on the current MTU setting. Jumbo Valid Range: 0-1 Default Value: 1 A value of '1' indicates that the driver should allow the use of Jumbo frames. The actual frame size is controlled by the device MTU setting, set from ifconfig. Additional Configuration ======================== Configuring a network driver to load properly when the system is started is distribution dependent. Typically it involves adding an alias line to /etc/conf.modules as well as editing other system startup scripts and/or configuration files. Many popular Linux distributions ship with tools to make these changes for you. Refer to your distribution documentation to learn the proper way to configure a network device for your system. If during this process you are asked for the driver or module name, the driver name for the PRO/1000 is 'e1000'. Supported Adapters ================== This driver supports the following adapters. Name (board numbers) IBM Netfinity Gigabit Ethernet SX Adapter Intel(R) PRO/1000 Gigabit Server Adapter (700262-xxx, 717037-xxx) Intel(R) PRO/1000 Gigabit Adapter (738640-xxx) To verify your adapter is supported, find the Board ID number on the adapter. Look for a label that has a barcode and a number in the format of 123456-001 (six digits hyphen 3 digits). Match this to the list of numbers above. For more information on how to identify your adapter go to the Adapter & Driver ID Guide at: http://support.intel.com/support/network/adapter/pro100/21397.htm Support ======= For general information and peer to peer support go to the forum at: http://support.intel.com/newsgroups/netwadap.htm Read the forum charter, legal information, and posting guidelines before entering the forum. This forum will post new information regarding the driver as it becomes available. If an issue is identified with the released source code on the supported kernel with this adapter, email the specific information related to the issue to linux.nics@intel.com. License ======= Copyright (c) 1999 - 2000, Intel Corporation All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of Intel Corporation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.