sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget@/translations/zh_CN/networking/device_drivers/ethernet/intel/icemodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget@/translations/zh_TW/networking/device_drivers/ethernet/intel/icemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget@/translations/it_IT/networking/device_drivers/ethernet/intel/icemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget@/translations/ja_JP/networking/device_drivers/ethernet/intel/icemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget@/translations/ko_KR/networking/device_drivers/ethernet/intel/icemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget@/translations/sp_SP/networking/device_drivers/ethernet/intel/icemodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h!SPDX-License-Identifier: GPL-2.0+h]h!SPDX-License-Identifier: GPL-2.0+}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhZ/var/lib/git/docbuild/linux/Documentation/networking/device_drivers/ethernet/intel/ice.rsthKubhsection)}(hhh](htitle)}(hALinux Base Driver for the Intel(R) Ethernet Controller 800 Seriesh]hALinux Base Driver for the Intel(R) Ethernet Controller 800 Series}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hAIntel ice Linux driver. Copyright(c) 2018-2021 Intel Corporation.h]hAIntel ice Linux driver. Copyright(c) 2018-2021 Intel Corporation.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(hContentsh]hContents}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubh bullet_list)}(hhh](h list_item)}(hOverviewh]h)}(hhh]hOverview}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh)}(hIdentifying Your Adapterh]h)}(hj h]hIdentifying Your Adapter}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh)}(hImportant Notesh]h)}(hj!h]hImportant Notes}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh)}(h$Additional Features & Configurationsh]h)}(hj8h]h$Additional Features & Configurations}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj6ubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh)}(hPerformance Optimization h]h)}(hPerformance Optimizationh]hPerformance Optimization}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1hhhhK hhhhubh)}(hDThe associated Virtual Function (VF) driver for this driver is iavf.h]hDThe associated Virtual Function (VF) driver for this driver is iavf.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h;Driver information can be obtained using ethtool and lspci.h]h;Driver information can be obtained using ethtool and lspci.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hFor questions related to hardware requirements, refer to the documentation supplied with your Intel adapter. All hardware requirements listed apply to use with Linux.h]hFor questions related to hardware requirements, refer to the documentation supplied with your Intel adapter. All hardware requirements listed apply to use with Linux.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h|This driver supports XDP (Express Data Path) and AF_XDP zero-copy. Note that XDP is blocked for frame sizes larger than 3KB.h]h|This driver supports XDP (Express Data Path) and AF_XDP zero-copy. Note that XDP is blocked for frame sizes larger than 3KB.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]contentsah ]h"]contentsah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(hIdentifying Your Adapterh]hIdentifying Your Adapter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK!ubh)}(hFor information on how to identify your adapter, and for the latest Intel network drivers, refer to the Intel Support website: https://www.intel.com/supporth](hFor information on how to identify your adapter, and for the latest Intel network drivers, refer to the Intel Support website: }(hjhhhNhNubh reference)}(hhttps://www.intel.com/supporth]hhttps://www.intel.com/support}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhjubeh}(h]h ]h"]h$]h&]uh1hhhhK"hjhhubeh}(h]identifying-your-adapterah ]h"]identifying your adapterah$]h&]uh1hhhhhhhhK!ubh)}(hhh](h)}(hImportant Notesh]hImportant Notes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK(ubh)}(hhh](h)}(h+Packet drops may occur under receive stressh]h+Packet drops may occur under receive stress}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK+ubh)}(hXDevices based on the Intel(R) Ethernet Controller 800 Series are designed to tolerate a limited amount of system latency during PCIe and DMA transactions. If these transactions take longer than the tolerated latency, it can impact the length of time the packets are buffered in the device and associated memory, which may result in dropped packets. These packets drops typically do not have a noticeable impact on throughput and performance under standard workloads.h]hXDevices based on the Intel(R) Ethernet Controller 800 Series are designed to tolerate a limited amount of system latency during PCIe and DMA transactions. If these transactions take longer than the tolerated latency, it can impact the length of time the packets are buffered in the device and associated memory, which may result in dropped packets. These packets drops typically do not have a noticeable impact on throughput and performance under standard workloads.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hjhhubh)}(h^If these packet drops appear to affect your workload, the following may improve the situation:h]h^If these packet drops appear to affect your workload, the following may improve the situation:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjhhubhenumerated_list)}(hhh](h)}(hMake sure that your system's physical memory is in a high-performance configuration, as recommended by the platform vendor. A common recommendation is for all channels to be populated with a single DIMM module.h]h)}(hMake sure that your system's physical memory is in a high-performance configuration, as recommended by the platform vendor. A common recommendation is for all channels to be populated with a single DIMM module.h]hMake sure that your system’s physical memory is in a high-performance configuration, as recommended by the platform vendor. A common recommendation is for all channels to be populated with a single DIMM module.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hj(ubah}(h]h ]h"]h$]h&]uh1hhj%hhhhhNubh)}(hFIn your system's BIOS/UEFI settings, select the "Performance" profile.h]h)}(hjBh]hLIn your system’s BIOS/UEFI settings, select the “Performance” profile.}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hj@ubah}(h]h ]h"]h$]h&]uh1hhj%hhhhhNubh)}(hYour distribution may provide tools like "tuned," which can help tweak kernel settings to achieve better standard settings for different workloads. h]h)}(hYour distribution may provide tools like "tuned," which can help tweak kernel settings to achieve better standard settings for different workloads.h]hYour distribution may provide tools like “tuned,” which can help tweak kernel settings to achieve better standard settings for different workloads.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hjWubah}(h]h ]h"]h$]h&]uh1hhj%hhhhhNubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix)uh1j#hjhhhhhK6ubeh}(h]+packet-drops-may-occur-under-receive-stressah ]h"]+packet drops may occur under receive stressah$]h&]uh1hhjhhhhhK+ubh)}(hhh](h)}(h0Configuring SR-IOV for improved network securityh]h0Configuring SR-IOV for improved network security}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK@ubh)}(hXIn 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.h]hXIn 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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjhhubh)}(hsSee "Configuring VLAN Tagging on SR-IOV Enabled Adapter Ports" later in this README for configuration instructions.h]hwSee “Configuring VLAN Tagging on SR-IOV Enabled Adapter Ports” later in this README for configuration instructions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjhhubeh}(h]0configuring-sr-iov-for-improved-network-securityah ]h"]0configuring sr-iov for improved network securityah$]h&]uh1hhjhhhhhK@ubh)}(hhh](h)}(h=Do not unload port driver if VF with active VM is bound to ith]h=Do not unload port driver if VF with active VM is bound to it}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKPubh)}(hDo 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.h]hDo 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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhjhhubeh}(h]=do-not-unload-port-driver-if-vf-with-active-vm-is-bound-to-itah ]h"]=do not unload port driver if vf with active vm is bound to itah$]h&]uh1hhjhhhhhKPubeh}(h]important-notesah ]h"]important notesah$]h&]uh1hhhhhhhhK(ubh)}(hhh](h)}(h&Additional Features and Configurationsh]h&Additional Features and Configurations}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKXubh)}(hhh](h)}(hethtoolh]hethtool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK[ubh)}(hXThe driver utilizes the ethtool interface for driver configuration and diagnostics, as well as displaying statistical information. The latest ethtool version is required for this functionality. Download it at: https://kernel.org/pub/software/network/ethtool/h](hThe driver utilizes the ethtool interface for driver configuration and diagnostics, as well as displaying statistical information. The latest ethtool version is required for this functionality. Download it at: }(hjhhhNhNubj)}(h0https://kernel.org/pub/software/network/ethtool/h]h0https://kernel.org/pub/software/network/ethtool/}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhjubeh}(h]h ]h"]h$]h&]uh1hhhhK\hjhhubh)}(hXNOTE: The rx_bytes value of ethtool does not match the rx_bytes value of Netdev, due to the 4-byte CRC being stripped by the device. The difference between the two rx_bytes values will be 4 x the number of Rx packets. For example, if Rx packets are 10 and Netdev (software statistics) displays rx_bytes as "X", then ethtool (hardware statistics) will display rx_bytes as "X+40" (4 bytes CRC x 10 packets).h]hXNOTE: The rx_bytes value of ethtool does not match the rx_bytes value of Netdev, due to the 4-byte CRC being stripped by the device. The difference between the two rx_bytes values will be 4 x the number of Rx packets. For example, if Rx packets are 10 and Netdev (software statistics) displays rx_bytes as “X”, then ethtool (hardware statistics) will display rx_bytes as “X+40” (4 bytes CRC x 10 packets).}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKahjhhubeh}(h]ethtoolah ]h"]ethtoolah$]h&]uh1hhjhhhhhK[ubh)}(hhh](h)}(h ethtool reseth]h ethtool reset}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hhhhhKiubh)}(h&The driver supports 3 types of resets:h]h&The driver supports 3 types of resets:}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKjhj;hhubh)}(hhh](h)}(hZPF reset - resets only components associated with the given PF, does not impact other PFs h]h)}(hYPF reset - resets only components associated with the given PF, does not impact other PFsh]hYPF reset - resets only components associated with the given PF, does not impact other PFs}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKlhj]ubah}(h]h ]h"]h$]h&]uh1hhjZhhhhhNubh)}(h6CORE reset - whole adapter is affected, reset all PFs h]h)}(h5CORE reset - whole adapter is affected, reset all PFsh]h5CORE reset - whole adapter is affected, reset all PFs}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKohjuubah}(h]h ]h"]h$]h&]uh1hhjZhhhhhNubh)}(hNGLOBAL reset - same as CORE but mac and phy components are also reinitialized h]h)}(hMGLOBAL reset - same as CORE but mac and phy components are also reinitializedh]hMGLOBAL reset - same as CORE but mac and phy components are also reinitialized}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKqhjubah}(h]h ]h"]h$]h&]uh1hhjZhhhhhNubeh}(h]h ]h"]h$]h&]jkjluh1hhhhKlhj;hhubh)}(h2These are mapped to ethtool reset flags as follow:h]h2These are mapped to ethtool reset flags as follow:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshj;hhubh)}(hhh](h)}(h;PF reset: # ethtool --reset irq dma filter offload h](h)}(h PF reset:h]h PF reset:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhjubh)}(h/# ethtool --reset irq dma filter offloadh]h/# ethtool --reset irq dma filter offload}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKwhjubeh}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(hfCORE reset: # ethtool --reset irq-shared dma-shared filter-shared offload-shared \ ram-shared h](h)}(h CORE reset:h]h CORE reset:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhjubh)}(hX# ethtool --reset irq-shared dma-shared filter-shared offload-shared \ ram-sharedh]hX# ethtool --reset irq-shared dma-shared filter-shared offload-shared ram-shared}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK{hjubeh}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(h~GLOBAL reset: # ethtool --reset irq-shared dma-shared filter-shared offload-shared \ mac-shared phy-shared ram-shared h](h)}(h GLOBAL reset:h]h GLOBAL reset:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hjubh)}(hn# ethtool --reset irq-shared dma-shared filter-shared offload-shared \ mac-shared phy-shared ram-sharedh]hn# ethtool --reset irq-shared dma-shared filter-shared offload-shared mac-shared phy-shared ram-shared}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1hhjhhhhhNubeh}(h]h ]h"]h$]h&]jkjluh1hhhhKuhj;hhubh)}(h irq dma filter offload h]h)}(h/# ethtool --reset irq dma filter offloadh]h/# ethtool --reset irq dma filter offload}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjDubah}(h]h ]h"]h$]h&]uh1jBhhhKhj;hhubeh}(h] ethtool-resetah ]h"] ethtool resetah$]h&]uh1hhjhhhhhKiubh)}(hhh](h)}(hViewing Link Messagesh]hViewing Link Messages}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhhhhhKubh)}(hLink messages will not be displayed to the console if the distribution is restricting system messages. In order to see network driver link messages on your console, set dmesg to eight by entering the following::h]hLink messages will not be displayed to the console if the distribution is restricting system messages. In order to see network driver link messages on your console, set dmesg to eight by entering the following:}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjdhhubh literal_block)}(h # dmesg -n 8h]h # dmesg -n 8}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjdhhubh)}(h/NOTE: This setting is not saved across reboots.h]h/NOTE: This setting is not saved across reboots.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjdhhubeh}(h]viewing-link-messagesah ]h"]viewing link messagesah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hDynamic Device Personalizationh]hDynamic Device Personalization}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hX[Dynamic Device Personalization (DDP) allows you to change the packet processing pipeline of a device by applying a profile package to the device at runtime. Profiles can be used to, for example, add support for new protocols, change existing protocols, or change default settings. DDP profiles can also be rolled back without rebooting the system.h]hX[Dynamic Device Personalization (DDP) allows you to change the packet processing pipeline of a device by applying a profile package to the device at runtime. Profiles can be used to, for example, add support for new protocols, change existing protocols, or change default settings. DDP profiles can also be rolled back without rebooting the system.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hThe DDP package loads during device initialization. The driver looks for ``intel/ice/ddp/ice.pkg`` in your firmware root (typically ``/lib/firmware/`` or ``/lib/firmware/updates/``) and checks that it contains a valid DDP package file.h](hIThe DDP package loads during device initialization. The driver looks for }(hjhhhNhNubhliteral)}(h``intel/ice/ddp/ice.pkg``h]hintel/ice/ddp/ice.pkg}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh" in your firmware root (typically }(hjhhhNhNubj)}(h``/lib/firmware/``h]h/lib/firmware/}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh or }(hjhhhNhNubj)}(h``/lib/firmware/updates/``h]h/lib/firmware/updates/}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh7) and checks that it contains a valid DDP package file.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hNOTE: Your distribution should likely have provided the latest DDP file, but if ice.pkg is missing, you can find it in the linux-firmware repository or from intel.com.h]hNOTE: Your distribution should likely have provided the latest DDP file, but if ice.pkg is missing, you can find it in the linux-firmware repository or from intel.com.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXIf the driver is unable to load the DDP package, the device will enter Safe Mode. Safe Mode disables advanced and performance features and supports only basic traffic and minimal functionality, such as updating the NVM or downloading a new driver or DDP package. Safe Mode only applies to the affected physical function and does not impact any other PFs. See the "Intel(R) Ethernet Adapters and Devices User Guide" for more details on DDP and Safe Mode.h]hXIf the driver is unable to load the DDP package, the device will enter Safe Mode. Safe Mode disables advanced and performance features and supports only basic traffic and minimal functionality, such as updating the NVM or downloading a new driver or DDP package. Safe Mode only applies to the affected physical function and does not impact any other PFs. See the “Intel(R) Ethernet Adapters and Devices User Guide” for more details on DDP and Safe Mode.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hNOTES:h]hNOTES:}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hhh](h)}(hIf you encounter issues with the DDP package file, you may need to download an updated driver or DDP package file. See the log messages for more information. h]h)}(hIf you encounter issues with the DDP package file, you may need to download an updated driver or DDP package file. See the log messages for more information.h]hIf you encounter issues with the DDP package file, you may need to download an updated driver or DDP package file. See the log messages for more information.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj;ubah}(h]h ]h"]h$]h&]uh1hhj8hhhhhNubh)}(hEThe ice.pkg file is a symbolic link to the default DDP package file. h]h)}(hDThe ice.pkg file is a symbolic link to the default DDP package file.h]hDThe ice.pkg file is a symbolic link to the default DDP package file.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjSubah}(h]h ]h"]h$]h&]uh1hhj8hhhhhNubh)}(hYou cannot update the DDP package if any PF drivers are already loaded. To overwrite a package, unload all PFs and then reload the driver with the new package. h]h)}(hYou cannot update the DDP package if any PF drivers are already loaded. To overwrite a package, unload all PFs and then reload the driver with the new package.h]hYou cannot update the DDP package if any PF drivers are already loaded. To overwrite a package, unload all PFs and then reload the driver with the new package.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjkubah}(h]h ]h"]h$]h&]uh1hhj8hhhhhNubh)}(hLOnly the first loaded PF per device can download a package for that device. h]h)}(hKOnly the first loaded PF per device can download a package for that device.h]hKOnly the first loaded PF per device can download a package for that device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhj8hhhhhNubeh}(h]h ]h"]h$]h&]jkjluh1hhhhKhjhhubh)}(hYou can install specific DDP package files for different physical devices in the same system. To install a specific DDP package file:h]hYou can install specific DDP package files for different physical devices in the same system. To install a specific DDP package file:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj$)}(hhh](h)}(h8Download the DDP package file you want for your device. h]h)}(h7Download the DDP package file you want for your device.h]h7Download the DDP package file you want for your device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(hX Rename the file ice-xxxxxxxxxxxxxxxx.pkg, where 'xxxxxxxxxxxxxxxx' is the unique 64-bit PCI Express device serial number (in hex) of the device you want the package downloaded on. The filename must include the complete serial number (including leading zeros) and be all lowercase. For example, if the 64-bit serial number is b887a3ffffca0568, then the file name would be ice-b887a3ffffca0568.pkg. To find the serial number from the PCI bus address, you can use the following command:: # lspci -vv -s af:00.0 | grep -i Serial Capabilities: [150 v1] Device Serial Number b8-87-a3-ff-ff-ca-05-68 You can use the following command to format the serial number without the dashes:: # lspci -vv -s af:00.0 | grep -i Serial | awk '{print $7}' | sed s/-//g b887a3ffffca0568 h](h)}(hXRename the file ice-xxxxxxxxxxxxxxxx.pkg, where 'xxxxxxxxxxxxxxxx' is the unique 64-bit PCI Express device serial number (in hex) of the device you want the package downloaded on. The filename must include the complete serial number (including leading zeros) and be all lowercase. For example, if the 64-bit serial number is b887a3ffffca0568, then the file name would be ice-b887a3ffffca0568.pkg.h]hXRename the file ice-xxxxxxxxxxxxxxxx.pkg, where ‘xxxxxxxxxxxxxxxx’ is the unique 64-bit PCI Express device serial number (in hex) of the device you want the package downloaded on. The filename must include the complete serial number (including leading zeros) and be all lowercase. For example, if the 64-bit serial number is b887a3ffffca0568, then the file name would be ice-b887a3ffffca0568.pkg.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubh)}(hWTo find the serial number from the PCI bus address, you can use the following command::h]hVTo find the serial number from the PCI bus address, you can use the following command:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hk# lspci -vv -s af:00.0 | grep -i Serial Capabilities: [150 v1] Device Serial Number b8-87-a3-ff-ff-ca-05-68h]hk# lspci -vv -s af:00.0 | grep -i Serial Capabilities: [150 v1] Device Serial Number b8-87-a3-ff-ff-ca-05-68}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubh)}(hRYou can use the following command to format the serial number without the dashes::h]hQYou can use the following command to format the serial number without the dashes:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hX# lspci -vv -s af:00.0 | grep -i Serial | awk '{print $7}' | sed s/-//g b887a3ffffca0568h]hX# lspci -vv -s af:00.0 | grep -i Serial | awk '{print $7}' | sed s/-//g b887a3ffffca0568}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubeh}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(hCopy the renamed DDP package file to ``/lib/firmware/updates/intel/ice/ddp/``. If the directory does not yet exist, create it before copying the file. h]h)}(hCopy the renamed DDP package file to ``/lib/firmware/updates/intel/ice/ddp/``. If the directory does not yet exist, create it before copying the file.h](h%Copy the renamed DDP package file to }(hjhhhNhNubj)}(h(``/lib/firmware/updates/intel/ice/ddp/``h]h$/lib/firmware/updates/intel/ice/ddp/}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhI. If the directory does not yet exist, create it before copying the file.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(h%Unload all of the PFs on the device. h]h)}(h$Unload all of the PFs on the device.h]h$Unload all of the PFs on the device.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjDubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(h(Reload the driver with the new package. h]h)}(h'Reload the driver with the new package.h]h'Reload the driver with the new package.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj\ubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubeh}(h]h ]h"]h$]h&]jujvjwhjx.uh1j#hjhhhhhKubh)}(hyNOTE: The presence of a device-specific DDP package file overrides the loading of the default DDP package file (ice.pkg).h]hyNOTE: The presence of a device-specific DDP package file overrides the loading of the default DDP package file (ice.pkg).}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]dynamic-device-personalizationah ]h"]dynamic device personalizationah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hIntel(R) Ethernet Flow Directorh]hIntel(R) Ethernet Flow Director}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(h>The Intel Ethernet Flow Director performs the following tasks:h]h>The Intel Ethernet Flow Director performs the following tasks:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hhh](h)}(hDDirects receive packets according to their flows to different queuesh]h)}(hjh]hDDirects receive packets according to their flows to different queues}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(h7Enables tight control on routing a flow in the platformh]h)}(hjh]h7Enables tight control on routing a flow in the platform}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubh)}(h.Matches flows and CPU cores for flow affinity h]h)}(h-Matches flows and CPU cores for flow affinityh]h-Matches flows and CPU cores for flow affinity}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjhhhhhNubeh}(h]h ]h"]h$]h&]jkjluh1hhhhKhjhhubh)}(h4NOTE: This driver supports the following flow types:h]h4NOTE: This driver supports the following flow types:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hhh](h)}(hIPv4h]h)}(hjh]hIPv4}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhj hhhhhNubh)}(hTCPv4h]h)}(hj)h]hTCPv4}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj'ubah}(h]h ]h"]h$]h&]uh1hhj hhhhhNubh)}(hUDPv4h]h)}(hj@h]hUDPv4}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj>ubah}(h]h ]h"]h$]h&]uh1hhj hhhhhNubh)}(hSCTPv4h]h)}(hjWh]hSCTPv4}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjUubah}(h]h ]h"]h$]h&]uh1hhj hhhhhNubh)}(hIPv6h]h)}(hjnh]hIPv6}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjlubah}(h]h ]h"]h$]h&]uh1hhj hhhhhNubh)}(hTCPv6h]h)}(hjh]hTCPv6}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhj hhhhhNubh)}(hUDPv6h]h)}(hjh]hUDPv6}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhj hhhhhNubh)}(hSCTPv6 h]h)}(hSCTPv6h]hSCTPv6}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhj hhhhhNubeh}(h]h ]h"]h$]h&]jkjluh1hhhhKhjhhubh)}(hXEach flow type supports valid combinations of IP addresses (source or destination) and UDP/TCP/SCTP ports (source and destination). You can supply only a source IP address, a source IP address and a destination port, or any combination of one or more of these four parameters.h]hXEach flow type supports valid combinations of IP addresses (source or destination) and UDP/TCP/SCTP ports (source and destination). You can supply only a source IP address, a source IP address and a destination port, or any combination of one or more of these four parameters.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXhNOTE: This driver allows you to filter traffic based on a user-defined flexible two-byte pattern and offset by using the ethtool user-def and mask fields. Only L3 and L4 flow types are supported for user-defined flexible filters. For a given flow type, you must clear all Intel Ethernet Flow Director filters before changing the input set (for that flow type).h]hXhNOTE: This driver allows you to filter traffic based on a user-defined flexible two-byte pattern and offset by using the ethtool user-def and mask fields. Only L3 and L4 flow types are supported for user-defined flexible filters. For a given flow type, you must clear all Intel Ethernet Flow Director filters before changing the input set (for that flow type).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]intel-r-ethernet-flow-directorah ]h"]intel(r) ethernet flow directorah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hFlow Director Filtersh]hFlow Director Filters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hFlow Director filters are used to direct traffic that matches specified characteristics. They are enabled through ethtool's ntuple interface. To enable or disable the Intel Ethernet Flow Director and these filters::h]hFlow Director filters are used to direct traffic that matches specified characteristics. They are enabled through ethtool’s ntuple interface. To enable or disable the Intel Ethernet Flow Director and these filters:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h## ethtool -K ntuple h]h## ethtool -K ntuple }hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjhhubh)}(hNOTE: When you disable ntuple filters, all the user programmed filters are flushed from the driver cache and hardware. All needed filters must be re-added when ntuple is re-enabled.h]hNOTE: When you disable ntuple filters, all the user programmed filters are flushed from the driver cache and hardware. All needed filters must be re-added when ntuple is re-enabled.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh)}(h&To display all of the active filters::h]h%To display all of the active filters:}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj)}(h# ethtool -u h]h# ethtool -u }hj<sbah}(h]h ]h"]h$]h&]hhuh1jhhhM hjhhubh)}(hTo add a new filter::h]hTo add a new filter:}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjhhubj)}(hX# ethtool -U flow-type src-ip [m ] dst-ip [m ] src-port [m ] dst-port [m ] action Where: - the Ethernet device to program - can be ip4, tcp4, udp4, sctp4, ip6, tcp6, udp6, sctp6 - the IP address to match on - the IPv4 address to mask on NOTE: These filters use inverted masks. - the port number to match on - the 16-bit integer for masking NOTE: These filters use inverted masks. - the queue to direct traffic toward (-1 discards the matched traffic)h]hX# ethtool -U flow-type src-ip [m ] dst-ip [m ] src-port [m ] dst-port [m ] action Where: - the Ethernet device to program - can be ip4, tcp4, udp4, sctp4, ip6, tcp6, udp6, sctp6 - the IP address to match on - the IPv4 address to mask on NOTE: These filters use inverted masks. - the port number to match on - the 16-bit integer for masking NOTE: These filters use inverted masks. - the queue to direct traffic toward (-1 discards the matched traffic)}hjXsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjhhubh)}(hTo delete a filter::h]hTo delete a filter:}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj)}(h# ethtool -U delete Where is the filter ID displayed when printing all the active filters, and may also have been specified using "loc " when adding the filter.h]h# ethtool -U delete Where is the filter ID displayed when printing all the active filters, and may also have been specified using "loc " when adding the filter.}hjtsbah}(h]h ]h"]h$]h&]hhuh1jhhhM hjhhubh)}(h EXAMPLES:h]h EXAMPLES:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM%hjhhubh)}(h0To add a filter that directs packet to queue 2::h]h/To add a filter that directs packet to queue 2:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM'hjhhubj)}(hy# ethtool -U flow-type tcp4 src-ip 192.168.10.1 dst-ip \ 192.168.10.2 src-port 2000 dst-port 2001 action 2 [loc 1]h]hy# ethtool -U flow-type tcp4 src-ip 192.168.10.1 dst-ip \ 192.168.10.2 src-port 2000 dst-port 2001 action 2 [loc 1]}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhM)hjhhubh)}(hBTo set a filter using only the source and destination IP address::h]hATo set a filter using only the source and destination IP address:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM,hjhhubj)}(h]# ethtool -U flow-type tcp4 src-ip 192.168.10.1 dst-ip \ 192.168.10.2 action 2 [loc 1]h]h]# ethtool -U flow-type tcp4 src-ip 192.168.10.1 dst-ip \ 192.168.10.2 action 2 [loc 1]}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhM.hjhhubh)}(h flow-type tcp4 src-ip 192.168.10.1 dst-ip \ 192.168.10.2 user-def 0x4FFFF action 2 [loc 1] where the value of the user-def field contains the offset (4 bytes) and the pattern (0xffff).h]h# ethtool -U flow-type tcp4 src-ip 192.168.10.1 dst-ip \ 192.168.10.2 user-def 0x4FFFF action 2 [loc 1] where the value of the user-def field contains the offset (4 bytes) and the pattern (0xffff).}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhM3hjhhubh)}(hvTo match TCP traffic sent from 192.168.0.1, port 5300, directed to 192.168.0.5, port 80, and then send it to queue 7::h]huTo match TCP traffic sent from 192.168.0.1, port 5300, directed to 192.168.0.5, port 80, and then send it to queue 7:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM9hjhhubj)}(hm# ethtool -U enp130s0 flow-type tcp4 src-ip 192.168.0.1 dst-ip 192.168.0.5 src-port 5300 dst-port 80 action 7h]hm# ethtool -U enp130s0 flow-type tcp4 src-ip 192.168.0.1 dst-ip 192.168.0.5 src-port 5300 dst-port 80 action 7}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhM<hjhhubh)}(hBTo add a TCPv4 filter with a partial mask for a source IP subnet::h]hATo add a TCPv4 filter with a partial mask for a source IP subnet:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM?hjhhubj)}(h~# ethtool -U flow-type tcp4 src-ip 192.168.0.0 m 0.255.255.255 dst-ip 192.168.5.12 src-port 12600 dst-port 31 action 12h]h~# ethtool -U flow-type tcp4 src-ip 192.168.0.0 m 0.255.255.255 dst-ip 192.168.5.12 src-port 12600 dst-port 31 action 12}hj sbah}(h]h ]h"]h$]h&]hhuh1jhhhMAhjhhubh)}(hNOTES:h]hNOTES:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMDhjhhubh)}(hFor each flow-type, the programmed filters must all have the same matching input set. For example, issuing the following two commands is acceptable::h]hFor each flow-type, the programmed filters must all have the same matching input set. For example, issuing the following two commands is acceptable:}(hj* hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMFhjhhubj)}(h# ethtool -U enp130s0 flow-type ip4 src-ip 192.168.0.1 src-port 5300 action 7 # ethtool -U enp130s0 flow-type ip4 src-ip 192.168.0.5 src-port 55 action 10h]h# ethtool -U enp130s0 flow-type ip4 src-ip 192.168.0.1 src-port 5300 action 7 # ethtool -U enp130s0 flow-type ip4 src-ip 192.168.0.5 src-port 55 action 10}hj8 sbah}(h]h ]h"]h$]h&]hhuh1jhhhMIhjhhubh)}(h}Issuing the next two commands, however, is not acceptable, since the first specifies src-ip and the second specifies dst-ip::h]h|Issuing the next two commands, however, is not acceptable, since the first specifies src-ip and the second specifies dst-ip:}(hjF hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMLhjhhubj)}(h# ethtool -U enp130s0 flow-type ip4 src-ip 192.168.0.1 src-port 5300 action 7 # ethtool -U enp130s0 flow-type ip4 dst-ip 192.168.0.5 src-port 55 action 10h]h# ethtool -U enp130s0 flow-type ip4 src-ip 192.168.0.1 src-port 5300 action 7 # ethtool -U enp130s0 flow-type ip4 dst-ip 192.168.0.5 src-port 55 action 10}hjT sbah}(h]h ]h"]h$]h&]hhuh1jhhhMOhjhhubh)}(hThe second command will fail with an error. You may program multiple filters with the same fields, using different values, but, on one device, you may not program two tcp4 filters with different matching fields.h]hThe second command will fail with an error. You may program multiple filters with the same fields, using different values, but, on one device, you may not program two tcp4 filters with different matching fields.}(hjb hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMRhjhhubh)}(hpThe ice driver does not support matching on a subportion of a field, thus partial mask fields are not supported.h]hpThe ice driver does not support matching on a subportion of a field, thus partial mask fields are not supported.}(hjp hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMVhjhhubeh}(h]flow-director-filtersah ]h"]flow director filtersah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hFlex Byte Flow Director Filtersh]hFlex Byte Flow Director Filters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM[ubh)}(hThe driver also supports matching user-defined data within the packet payload. This flexible data is specified using the "user-def" field of the ethtool command in the following way:h]hThe driver also supports matching user-defined data within the packet payload. This flexible data is specified using the “user-def” field of the ethtool command in the following way:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM\hj hhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hj ubj )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hj ubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h``31 28 24 20 16``h]j)}(hj h]h31 28 24 20 16}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhhhMchj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(h``15 12 8 4 0``h]j)}(hj h]h15 12 8 4 0}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhhhMchj ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(h``offset into packet payload``h]j)}(hj h]hoffset into packet payload}(hj! hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhhhMdhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(h``2 bytes of flexible data``h]j)}(hj? h]h2 bytes of flexible data}(hjA hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj= ubah}(h]h ]h"]h$]h&]uh1hhhhMdhj: ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]colsKuh1j hj ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubh)}(h For example,h]h For example,}(hjs hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMghj hhubj)}(h... user-def 0x4FFFF ...h]h... user-def 0x4FFFF ...}hj sbah}(h]h ]h"]h$]h&]hhuh1jhhhMkhj hhubh)}(htells the filter to look 4 bytes into the payload and match that value against 0xFFFF. The offset is based on the beginning of the payload, and not the beginning of the packet. Thush]htells the filter to look 4 bytes into the payload and match that value against 0xFFFF. The offset is based on the beginning of the payload, and not the beginning of the packet. Thus}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMmhj hhubj)}(h'flow-type tcp4 ... user-def 0x8BEAF ...h]h'flow-type tcp4 ... user-def 0x8BEAF ...}hj sbah}(h]h ]h"]h$]h&]hhuh1jhhhMshj hhubh)}(h[would match TCP/IPv4 packets which have the value 0xBEAF 8 bytes into the TCP/IPv4 payload.h]h[would match TCP/IPv4 packets which have the value 0xBEAF 8 bytes into the TCP/IPv4 payload.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMuhj hhubh)}(hX:Note that ICMP headers are parsed as 4 bytes of header and 4 bytes of payload. Thus to match the first byte of the payload, you must actually add 4 bytes to the offset. Also note that ip4 filters match both ICMP frames as well as raw (unknown) ip4 frames, where the payload will be the L3 payload of the IP4 frame.h]hX:Note that ICMP headers are parsed as 4 bytes of header and 4 bytes of payload. Thus to match the first byte of the payload, you must actually add 4 bytes to the offset. Also note that ip4 filters match both ICMP frames as well as raw (unknown) ip4 frames, where the payload will be the L3 payload of the IP4 frame.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMxhj hhubh)}(hThe maximum offset is 64. The hardware will only read up to 64 bytes of data from the payload. The offset must be even because the flexible data is 2 bytes long and must be aligned to byte 0 of the packet payload.h]hThe maximum offset is 64. The hardware will only read up to 64 bytes of data from the payload. The offset must be even because the flexible data is 2 bytes long and must be aligned to byte 0 of the packet payload.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM~hj hhubh)}(hXThe user-defined flexible offset is also considered part of the input set and cannot be programmed separately for multiple filters of the same type. However, the flexible data is not part of the input set and multiple filters may use the same offset but match against different data.h]hXThe user-defined flexible offset is also considered part of the input set and cannot be programmed separately for multiple filters of the same type. However, the flexible data is not part of the input set and multiple filters may use the same offset but match against different data.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubeh}(h]flex-byte-flow-director-filtersah ]h"]flex byte flow director filtersah$]h&]uh1hhjhhhhhM[ubh)}(hhh](h)}(h RSS Hash Flowh]h RSS Hash Flow}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(hAllows you to set the hash bytes per flow type and any combination of one or more options for Receive Side Scaling (RSS) hash byte configuration.h]hAllows you to set the hash bytes per flow type and any combination of one or more options for Receive Side Scaling (RSS) hash byte configuration.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubj)}(hXa# ethtool -N rx-flow-hash