igb Linux* Base Driver for Intel(R) Ethernet Network Connection ================================================================================ May 15, 2019 ================================================================================ Contents ======== - Overview - Identifying Your Adapter - Building and Installation - Command Line Parameters - Additional Configurations - Known Issues - Support - License Important Notes =============== Configuring SR-IOV for improved network security ------------------------------------------------ In a virtualized environment, on Intel(R) Ethernet Network Adapters that support SR-IOV, the virtual function (VF) may be subject to malicious behavior. Software-generated layer two frames, like IEEE 802.3x (link flow control), IEEE 802.1Qbb (priority based flow-control), and others of this type, are not expected and can throttle traffic between the host and the virtual switch, reducing performance. To resolve this issue, and to ensure isolation from unintended traffic streams, configure all SR-IOV enabled ports for VLAN tagging from the administrative interface on the PF. This configuration allows unexpected, and potentially malicious, frames to be dropped. See "Configuring VLAN Tagging on SR-IOV Enabled Adapter Ports" in this README for configuration instructions. Overview ======== This driver supports kernel versions 2.6.30 or newer. The associated Virtual Function (VF) driver for this driver is igbvf. Driver information can be obtained using ethtool, lspci, and ifconfig. Instructions on updating ethtool can be found in the section Additional Configurations later in this document. This 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 drivers. For questions related to hardware requirements, refer to the documentation supplied with your Intel adapter. All hardware requirements listed apply to use with Linux. The igb driver supports IEEE 1588 time stamping for kernels 2.6.30 and newer. The igb driver supports 2.5 Gbps operating speed on 2500BASE-KX only for I354-based network connections. Identifying Your Adapter ======================== For information on how to identify your adapter, and for the latest Intel network drivers, refer to the Intel Support website: http://www.intel.com/support Building and Installation ========================= To build a binary RPM package of this driver -------------------------------------------- Note: RPM functionality has only been tested in Red Hat distributions. 1. Run the following command, where is the version number for the driver tar file. # rpmbuild -tb igb-.tar.gz NOTE: For the build to work properly, the currently running kernel MUST match the version and configuration of the installed kernel sources. If you have just recompiled the kernel, reboot the system before building. 2. After building the RPM, the last few lines of the tool output contain the location of the RPM file that was built. Install the RPM with one of the following commands, where is the location of the RPM file: # rpm -Uvh or # dnf/yum localinstall NOTES: - To compile the driver on some kernel/arch combinations, you may need to install a package with the development version of libelf (e.g. libelf-dev, libelf-devel, elfutilsl-libelf-devel). - When compiling an out-of-tree driver, details will vary by distribution. However, you will usually need a kernel-devel RPM or some RPM that provides the kernel headers at a minimum. The RPM kernel-devel will usually fill in the link at /lib/modules/'uname -r'/build. To manually build the driver ---------------------------- 1. Move the base driver tar file to the directory of your choice. For example, use '/home/username/igb' or '/usr/local/src/igb'. 2. Untar/unzip the archive, where is the version number for the driver tar file: # tar zxf igb-.tar.gz 3. Change to the driver src directory, where is the version number for the driver tar: # cd igb-/src/ 4. Compile the driver module: # make install The binary will be installed as: /lib/modules//updates/drivers/net/ethernet/intel/igb/igb.ko The install location listed above is the default location. This may differ for various Linux distributions. 5. Load the module using the modprobe command. To check the version of the driver and then load it: # modinfo igb # modprobe igb [parameter=port1_value,port2_value] Alternately, make sure that any older igb drivers are removed from the kernel before loading the new module: # rmmod igb; modprobe igb 6. Assign an IP address to the interface by entering the following, where is the interface name that was shown in dmesg after modprobe: # ip address add / dev 7. Verify that the interface works. Enter the following, where IP_address is the IP address for another machine on the same subnet as the interface that is being tested: # ping Note: For certain distributions like (but not limited to) Red Hat Enterprise Linux 7 and Ubuntu, once the driver is installed, you may need to update the initrd/initramfs file to prevent the OS loading old versions of the igb driver. Use the dracut utility on Red Hat distributions: # dracut --force For Ubuntu: # update-initramfs -u To build igb driver with DCA ---------------------------- If your kernel supports DCA, the driver will build by default with DCA enabled. Command Line Parameters ======================= If the driver is built as a module, the following optional parameters are used by entering them on the command line with the modprobe command using this syntax: # modprobe igb [