From 4cde18977f9e8d131d29fb046b98e16592c71046 Mon Sep 17 00:00:00 2001 From: Aleksandr Loktionov Date: Wed, 28 Aug 2024 22:09:56 +0200 Subject: [PATCH] Intel official release 5.21.5 --- README | 2351 +++++++++++++++++------------- SUMS | 144 +- ixgbe.7 | 2823 ++++++++++++++++++++++++++++++++++--- ixgbe.spec | 13 +- pci.updates | 11 +- src/Makefile | 9 +- src/common.mk | 59 +- src/ixgbe.h | 61 +- src/ixgbe_82598.c | 2 +- src/ixgbe_82598.h | 2 +- src/ixgbe_82599.c | 15 +- src/ixgbe_82599.h | 2 +- src/ixgbe_api.c | 73 +- src/ixgbe_api.h | 7 +- src/ixgbe_common.c | 30 +- src/ixgbe_common.h | 2 +- src/ixgbe_dcb.c | 2 +- src/ixgbe_dcb.h | 2 +- src/ixgbe_dcb_82598.c | 2 +- src/ixgbe_dcb_82598.h | 2 +- src/ixgbe_dcb_82599.c | 2 +- src/ixgbe_dcb_82599.h | 2 +- src/ixgbe_dcb_nl.c | 4 +- src/ixgbe_debugfs.c | 1078 +++++++++++++- src/ixgbe_ethtool.c | 241 +++- src/ixgbe_fcoe.c | 14 +- src/ixgbe_fcoe.h | 2 +- src/ixgbe_lib.c | 14 +- src/ixgbe_main.c | 1470 ++++++++++++++++++- src/ixgbe_mbx.c | 5 +- src/ixgbe_mbx.h | 2 +- src/ixgbe_model.h | 2 +- src/ixgbe_osdep.h | 34 +- src/ixgbe_osdep2.h | 2 +- src/ixgbe_param.c | 8 +- src/ixgbe_phy.c | 6 +- src/ixgbe_phy.h | 2 +- src/ixgbe_procfs.c | 2 +- src/ixgbe_ptp.c | 23 +- src/ixgbe_sriov.c | 42 +- src/ixgbe_sriov.h | 2 +- src/ixgbe_sysfs.c | 10 +- src/ixgbe_txrx_common.h | 2 +- src/ixgbe_type.h | 67 +- src/ixgbe_x540.c | 2 +- src/ixgbe_x540.h | 2 +- src/ixgbe_x550.c | 2 +- src/ixgbe_x550.h | 2 +- src/ixgbe_xsk.c | 11 +- src/kcompat-generator.sh | 217 ++- src/kcompat-lib.sh | 139 +- src/kcompat.c | 67 +- src/kcompat.h | 84 +- src/kcompat_defs.h | 2 +- src/kcompat_ethtool.c | 2 +- src/kcompat_gcc.h | 30 +- src/kcompat_impl.h | 1012 +++++++++++-- src/kcompat_overflow.h | 278 +++- src/kcompat_pldmfw.c | 5 +- src/kcompat_pldmfw.h | 2 +- src/kcompat_rhel_defs.h | 11 +- src/kcompat_sles_defs.h | 3 +- src/kcompat_std_defs.h | 16 +- src/kcompat_ubuntu_defs.h | 2 +- 64 files changed, 8675 insertions(+), 1862 deletions(-) diff --git a/README b/README index 42f2672..c86fd86 100644 --- a/README +++ b/README @@ -1,477 +1,651 @@ - ixgbe Linux* Base Driver for Intel(R) Ethernet Network Connections -================================================================== +****************************************************************** + +July 16, 2024 -November 15, 2021 Contents --------- +^^^^^^^^ + +* ixgbe Linux* Base Driver for Intel(R) Ethernet Network Connections + + * Overview + + * Related Documentation + + * Identifying Your Adapter + + * Important Notes + + * Building and Installation + + * Command Line Parameters -- Overview -- Identifying Your Adapter -- Important Notes -- Building and Installation -- Command Line Parameters -- Additional Features and Configurations -- Known Issues/Troubleshooting -- Support -- License + * Additional Features and Configurations + + * Known Issues/Troubleshooting + + * Support + + * License + + * Trademarks Overview ======== -This driver supports kernel versions 2.6.x and newer. However, some features -may require a newer kernel version. The associated Virtual Function (VF) driver -for this driver is ixgbevf. - -Driver information can be obtained using ethtool, lspci, and ip. 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. - -This driver supports XDP (Express Data Path) on kernel 4.14 and later and -AF_XDP zero-copy on kernel 4.18 and later. Note that XDP is blocked for frame -sizes larger than 3KB. - -NOTE: Devices based on the Intel(R) Ethernet Connection X552 and Intel(R) -Ethernet Connection X553 do not support the following features: -* Energy Efficient Ethernet (EEE) -* Intel PROSet for Windows Device Manager -* Intel ANS teams or VLANs (LBFO is supported) -* Fibre Channel over Ethernet (FCoE) -* Data Center Bridging (DCB) -* IPSec Offloading -* MACSec Offloading -In addition, SFP+ devices based on the Intel(R) Ethernet Connection X552 and -Intel(R) Ethernet Connection X553 do not support the following features: -* Speed and duplex auto-negotiation. -* Wake on LAN -* 1000BASE-T SFP Modules + +This driver supports Linux* kernel versions 2.6.x and newer. However, +some features may require a newer kernel version. The associated +Virtual Function (VF) driver for this driver is ixgbevf. + +Driver information can be obtained using ethtool, lspci, and ip. +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. + +This driver supports XDP (Express Data Path) on kernel 4.14 and later +and AF_XDP zero-copy on kernel 4.18 and later. Note that XDP is +blocked for frame sizes larger than 3KB. + +Note: + + Devices based on the Intel(R) Ethernet Connection X552 and Intel(R) + Ethernet Connection X553 do not support the following features: + + * Energy Efficient Ethernet (EEE) + + * Intel PROSet for Windows Device Manager + + * Intel ANS teams or VLANs (LBFO is supported) + + * Fibre Channel over Ethernet (FCoE) + + * Data Center Bridging (DCB) + + * IPSec Offloading + + * MACSec Offloading + + In addition, SFP+ devices based on the Intel(R) Ethernet Connection + X552 and Intel(R) Ethernet Connection X553 do not support the + following features: + + * Speed and duplex auto-negotiation + + * Wake on LAN + + * 1000BASE-T SFP Modules Related Documentation ===================== -See the "Intel(R) Ethernet Adapters and Devices User Guide" for additional -information on features. It is available on the Intel website at either of the -following: - -- https://cdrdv2.intel.com/v1/dl/getContent/705831 -- -https://www.intel.com/content/www/us/en/download/19373/adapter-user-guide-for-in -tel-ethernet-adapters.html +See the "Intel(R) Ethernet Adapters and Devices User Guide" for +additional information on features. It is available on the Intel +website at https://cdrdv2.intel.com/v1/dl/getContent/705831. Identifying Your Adapter ======================== + The driver is compatible with devices based on the following: - * Intel(R) Ethernet Controller 82598 - * Intel(R) Ethernet Controller 82599 - * Intel(R) Ethernet Controller X520 - * Intel(R) Ethernet Controller X540 - * Intel(R) Ethernet Controller x550 - * Intel(R) Ethernet Controller X552 - * Intel(R) Ethernet Controller X553 -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 +* Intel(R) Ethernet Controller 82598 + +* Intel(R) Ethernet Controller 82599 + +* Intel(R) Ethernet Controller X520 + +* Intel(R) Ethernet Controller X540 + +* Intel(R) Ethernet Controller x550 + +* Intel(R) Ethernet Controller X552 + +* Intel(R) Ethernet Controller X553 + +For information on how to identify your adapter, and for the latest +Intel network drivers, refer to the Intel Support website at +https://www.intel.com/support. SFP+ Devices with Pluggable Optics ---------------------------------- -82599-BASED ADAPTERS --------------------- -NOTES: -- If your 82599-based Intel(R) Network Adapter came with Intel optics or is an - Intel(R) Ethernet Server Adapter X520-2, then it only supports Intel optics - and/or the direct attach cables listed below. -- When 82599-based SFP+ devices are connected back to back, they should be - set to the same Speed setting via ethtool. Results may vary if you mix - speed settings. - -Supplier Type Part Numbers --------- ---- ------------ -SR Modules -Intel DUAL RATE 1G/10G SFP+ SR (bailed) FTLX8571D3BCV-IT -Intel DUAL RATE 1G/10G SFP+ SR (bailed) AFBR-703SDZ-IN2 -Intel DUAL RATE 1G/10G SFP+ SR (bailed) AFBR-703SDDZ-IN1 -LR Modules -Intel DUAL RATE 1G/10G SFP+ LR (bailed) FTLX1471D3BCV-IT -Intel DUAL RATE 1G/10G SFP+ LR (bailed) AFCT-701SDZ-IN2 -Intel DUAL RATE 1G/10G SFP+ LR (bailed) AFCT-701SDDZ-IN1 - -The following is a list of 3rd party SFP+ modules that have received some -testing. Not all modules are applicable to all devices. - -Supplier Type Part Numbers --------- ---- ------------ -Finisar SFP+ SR bailed, 10g single rate FTLX8571D3BCL -Avago SFP+ SR bailed, 10g single rate AFBR-700SDZ -Finisar SFP+ LR bailed, 10g single rate FTLX1471D3BCL -Finisar DUAL RATE 1G/10G SFP+ SR (No Bail) FTLX8571D3QCV-IT -Avago DUAL RATE 1G/10G SFP+ SR (No Bail) AFBR-703SDZ-IN1 -Finisar DUAL RATE 1G/10G SFP+ LR (No Bail) FTLX1471D3QCV-IT -Avago DUAL RATE 1G/10G SFP+ LR (No Bail) AFCT-701SDZ-IN1 - -Finisar 1000BASE-T SFP FCLF8522P2BTL -Avago 1000BASE-T ABCU-5710RZ -HP 1000BASE-SX SFP 453153-001 - -82599-based adapters support all passive and active limiting direct attach -cables that comply with SFF-8431 v4.1 and SFF-8472 v10.4 specifications. +82599-Based Adapters +~~~~~~~~~~~~~~~~~~~~ + +Note: + + * If your 82599-based Intel(R) Network Adapter came with Intel + optics or is an Intel(R) Ethernet Server Adapter X520-2, then it + only supports Intel optics and/or the direct attach cables listed + below. + + * When 82599-based SFP+ devices are connected back to back, they + should be set to the same Speed setting via ethtool. Results may + vary if you mix speed settings. + ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Supplier | Type | Part Numbers | +|===================================|===================================|===================================| +| **SR Modules:** | | | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Intel | DUAL RATE 1G/10G SFP+ SR (bailed) | FTLX8571D3BCV-IT | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Intel | DUAL RATE 1G/10G SFP+ SR (bailed) | AFBR-703SDZ-IN2 | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Intel | DUAL RATE 1G/10G SFP+ SR (bailed) | AFBR-703SDDZ-IN1 | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| **LR Modules:** | | | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Intel | DUAL RATE 1G/10G SFP+ LR (bailed) | FTLX1471D3BCV-IT | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Intel | DUAL RATE 1G/10G SFP+ LR (bailed) | AFCT-701SDZ-IN2 | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Intel | DUAL RATE 1G/10G SFP+ LR (bailed) | AFCT-701SDDZ-IN1 | ++-----------------------------------+-----------------------------------+-----------------------------------+ + +The following is a list of third-party SFP+ modules that have received +some testing. Not all modules are applicable to all devices. + ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Supplier | Type | Part Numbers | +|===================================|===================================|===================================| +| Finisar | SFP+ SR bailed, 10g single rate | FTLX8571D3BCL | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Avago | SFP+ SR bailed, 10g single rate | AFBR-700SDZ | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Finisar | SFP+ LR bailed, 10g single rate | FTLX1471D3BCL | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Finisar | DUAL RATE 1G/10G SFP+ SR (No | FTLX8571D3QCV-IT | +| | Bail) | | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Avago | DUAL RATE 1G/10G SFP+ SR (No | AFBR-703SDZ-IN1 | +| | Bail) | | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Finisar | DUAL RATE 1G/10G SFP+ LR (No | FTLX1471D3QCV-IT | +| | Bail) | | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Avago | DUAL RATE 1G/10G SFP+ LR (No | AFCT-701SDZ-IN1 | +| | Bail) | | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Finisar | 1000BASE-T SFP | FCLF8522P2BTL | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Avago | 1000BASE-T | ABCU-5710RZ | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| HP | 1000BASE-SX SFP | 453153-001 | ++-----------------------------------+-----------------------------------+-----------------------------------+ + +82599-based adapters support all passive and active limiting direct +attach cables that comply with SFF-8431 v4.1 and SFF-8472 v10.4 +specifications. Turning the laser off or on for SFP+ ------------------------------------- -Use "ip link set [down/up] dev " to turn the -laser off and on. +"""""""""""""""""""""""""""""""""""" + +Use the following to turn the laser off and on: + ip link set [down|up] dev -82599-based QSFP+ Adapters + +82599-Based QSFP+ Adapters -------------------------- -NOTES: -- If your 82599-based Intel(R) Network Adapter came with Intel optics, it - only supports Intel optics. -- 82599-based QSFP+ adapters only support 4x10 Gbps connections. - 1x40 Gbps connections are not supported. QSFP+ link partners must be - configured for 4x10 Gbps. -- 82599-based QSFP+ adapters do not support automatic link speed detection. - The link speed must be configured to either 10 Gbps or 1 Gbps to match the - link partners speed capabilities. Incorrect speed configurations will result - in failure to link. -- Intel(R) Ethernet Converged Network Adapter X520-Q1 only supports the - optics and direct attach cables listed below. +Note: + + * If your 82599-based Intel(R) Network Adapter came with Intel + optics, it only supports Intel optics. + + * 82599-based QSFP+ adapters only support 4x10 Gbps connections. + 1x40 Gbps connections are not supported. QSFP+ link partners must + be configured for 4x10 Gbps. + * 82599-based QSFP+ adapters do not support automatic link speed + detection. The link speed must be configured to either 10 Gbps or + 1 Gbps to match the link partners speed capabilities. Incorrect + speed configurations will result in failure to link. -Supplier Type Part Numbers --------- ---- ------------ -Intel DUAL RATE 1G/10G QSFP+ SRL (bailed) E10GQSFPSR + * Intel(R) Ethernet Converged Network Adapter X520-Q1 only supports + the optics and direct attach cables listed below. -82599-based QSFP+ adapters support all passive and active limiting QSFP+ -direct attach cables that comply with SFF-8436 v4.1 specifications. ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Supplier | Type | Part Numbers | +|===================================|===================================|===================================| +| Intel | DUAL RATE 1G/10G QSFP+ SRL | E10GQSFPSR | +| | (bailed) | | ++-----------------------------------+-----------------------------------+-----------------------------------+ +82599-based QSFP+ adapters support all passive and active limiting +QSFP+ direct attach cables that comply with SFF-8436 v4.1 +specifications. -82598-BASED ADAPTERS + +82598-Based Adapters -------------------- -NOTES: -- Intel(r) Ethernet Network Adapters that support removable optical modules - only support their original module type (for example, the Intel(R) 10 Gigabit - SR Dual Port Express Module only supports SR optical modules). If you plug - in a different type of module, the driver will not load. -- Hot Swapping/hot plugging optical modules is not supported. -- Only single speed, 10 gigabit modules are supported. -- LAN on Motherboard (LOMs) may support DA, SR, or LR modules. Other module - types are not supported. Please see your system documentation for details. - - The following is a list of SFP+ modules and direct attach cables that have - received some testing. Not all modules are applicable to all devices. - -Supplier Type Part Numbers --------- ---- ------------ -Finisar SFP+ SR bailed, 10g single rate FTLX8571D3BCL -Avago SFP+ SR bailed, 10g single rate AFBR-700SDZ -Finisar SFP+ LR bailed, 10g single rate FTLX1471D3BCL - -82598-based adapters support all passive direct attach cables that comply with -SFF-8431 v4.1 and SFF-8472 v10.4 specifications. Active direct attach cables -are not supported. - -Third party optic modules and cables referred to above are listed only for the -purpose of highlighting third party specifications and potential -compatibility, and are not recommendations or endorsements or sponsorship of -any third party's product by Intel. Intel is not endorsing or promoting -products made by any third party and the third party reference is provided -only to share information regarding certain optic modules and cables with the -above specifications. There may be other manufacturers or suppliers, producing -or supplying optic modules and cables with similar or matching descriptions. -Customers must use their own discretion and diligence to purchase optic -modules and cables from any third party of their choice. Customers are solely -responsible for assessing the suitability of the product and/or devices and -for the selection of the vendor for purchasing any product. THE OPTIC MODULES -AND CABLES REFERRED TO ABOVE ARE NOT WARRANTED OR SUPPORTED BY INTEL. INTEL -ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED -WARRANTY, RELATING TO SALE AND/OR USE OF SUCH THIRD PARTY PRODUCTS OR -SELECTION OF VENDOR BY CUSTOMERS. +Note: + + * Intel(R) Ethernet Network Adapters that support removable optical + modules only support their original module type (for example, the + Intel(R) 10 Gigabit SR Dual Port Express Module only supports SR + optical modules). If you plug in a different type of module, the + driver will not load. + + * Hot Swapping/hot plugging optical modules is not supported. + + * Only single speed, 10 gigabit modules are supported. + + * LAN on Motherboard (LOMs) may support DA, SR, or LR modules. Other + module types are not supported. Please see your system + documentation for details. + +The following is a list of SFP+ modules and direct attach cables that +have received some testing. Not all modules are applicable to all +devices. + ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Supplier | Type | Part Numbers | +|===================================|===================================|===================================| +| Finisar | SFP+ SR bailed, 10g single rate | FTLX8571D3BCL | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Avago | SFP+ SR bailed, 10g single rate | AFBR-700SDZ | ++-----------------------------------+-----------------------------------+-----------------------------------+ +| Finisar | SFP+ LR bailed, 10g single rate | FTLX1471D3BCL | ++-----------------------------------+-----------------------------------+-----------------------------------+ + +82598-based adapters support all passive direct attach cables that +comply with SFF-8431 v4.1 and SFF-8472 v10.4 specifications. Active +direct attach cables are not supported. + +Third-party optic modules and cables referred to above are listed only +for the purpose of highlighting third party specifications and +potential compatibility, and are not recommendations or endorsements +or sponsorship of any third party's product by Intel. Intel is not +endorsing or promoting products made by any third party and the third +party reference is provided only to share information regarding +certain optic modules and cables with the above specifications. There +may be other manufacturers or suppliers, producing or supplying optic +modules and cables with similar or matching descriptions. Customers +must use their own discretion and diligence to purchase optic modules +and cables from any third party of their choice. Customers are solely +responsible for assessing the suitability of the product and/or +devices and for the selection of the vendor for purchasing any +product. THE OPTIC MODULES AND CABLES REFERRED TO ABOVE ARE NOT +WARRANTED OR SUPPORTED BY INTEL. INTEL ASSUMES NO LIABILITY +WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, +RELATING TO SALE AND/OR USE OF SUCH THIRD PARTY PRODUCTS OR SELECTION +OF VENDOR BY CUSTOMERS. Important Notes =============== + Do not unload port driver if VF with active VM is bound to it ------------------------------------------------------------- -Do not unload a port's driver if a Virtual Function (VF) with an active Virtual -Machine (VM) is bound to it. Doing so will cause the port to appear to hang. -Once the VM shuts down, or otherwise releases the VF, the command will complete. + +Do not unload a port's driver if a Virtual Function (VF) with an +active Virtual Machine (VM) is bound to it. Doing so will cause the +port to appear to hang. Once the VM shuts down, or otherwise releases +the VF, the command will complete. Configuring SR-IOV for improved network security ------------------------------------------------ -In a virtualized environment, on Intel(R) Ethernet Network Adapters that -support SR-IOV or Intel(R) Scalable I/O Virtualization (Intel(R) Scalable 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 or Intel Scalable IOV enabled -ports for VLAN tagging from the administrative interface on the PF. This -configuration allows unexpected, and potentially malicious, frames to be -dropped. + +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. Building and Installation ========================= + To manually build the driver ---------------------------- -1. Move the base driver tar file to the directory of your choice. - For example, use '/home/username/ixgbe' or '/usr/local/src/ixgbe'. -2. Untar/unzip the archive, where is the version number for the - driver tar file: +1. Move the base driver tar file to the directory of your choice. For + example, use "/home/username/ixgbe" or "/usr/local/src/ixgbe". - # tar zxf ixgbe-.tar.gz +2. Untar/unzip the archive, where "" is the version number for + the driver tar file: -3. Change to the driver src directory, where is the version number - for the driver tar: + tar zxf ixgbe-.tar.gz - # cd ixgbe-/src/ +3. Change to the driver src directory, where "" is the version + number for the driver tar: + + cd ixgbe-/src/ 4. Compile the driver module: - # make install + make install The binary will be installed as: - /lib/modules//updates/drivers/net/ethernet/intel/ixgbe/ixgbe.ko - The install location listed above is the default location. This may differ - for various Linux distributions. + /lib/modules//updates/drivers/net/ethernet/intel/ixgbe/ixgbe.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 ixgbe - # modprobe ixgbe [parameter=port1_value,port2_value] + modinfo ixgbe + modprobe ixgbe [parameter=port1_value,port2_value] - Alternately, make sure that any older ixgbe drivers are removed from the - kernel before loading the new module: + Alternately, make sure that any older ixgbe drivers are removed + from the kernel before loading the new module: - # rmmod ixgbe; modprobe ixgbe + rmmod ixgbe; modprobe ixgbe 6. Assign an IP address to the interface by entering the following, - where is the interface name that was shown in dmesg after modprobe: + where "" is the interface name that was shown in dmesg after + modprobe: - # ip address add / dev + 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: +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 + 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 ixgbe -driver. - For Red Hat distributions: - # dracut --force +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 ixgbe driver.For Red Hat distributions: + + dracut --force + + For Ubuntu: + + update-initramfs -u - For Ubuntu: - # update-initramfs -u - 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. +Note: - # rpmbuild -tb ixgbe-.tar.gz + RPM functionality has only been tested in Red Hat distributions. - 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. +1. Run the following command, where "" is the version number + for the driver tar file: -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: + rpmbuild -tb ixgbe-.tar.gz - # rpm -Uvh - or - # dnf/yum localinstall + Note: -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, elfutils-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. + 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 + +Note: + + * 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, elfutils-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 build ixgbe driver with DCA ------------------------------ -If your kernel supports DCA, the driver will build by default with DCA enabled. -Note: DCA is not supported on X550-based adapters. +If your kernel supports Direct Cache Access (DCA), the driver will +build by default with DCA enabled. + +Note: + DCA is not supported on X550-based adapters. Command Line Parameters ======================= -If the driver is built as a module, enter optional parameters on the command -line with the following syntax: -# modprobe ixgbe [