Intel® Ethernet Controller E810 Data Plane Development Kit (DPDK) 22.11/23.03

Configuration Guide

ID Date Version Classification
764257 06/16/2023 22.11 Public
Document Table of Contents
Document Table of Contents
Notices and Disclaimers Revision History Introduction DPDK Requirements DPDK Installation and Configuration Virtual Function (VF) Setup with DPDK Advanced Features and Debug Test Applications (pktgen and testpmd)
Notices and Disclaimers
Revision History
Introduction
Introduction DPDK Overview Known Issues
DPDK Overview
Known Issues
DPDK Requirements
System Requirements Software/Firmware Requirements
System Requirements
Software/Firmware Requirements
Software/Firmware Requirements Updating the NVM with a DPDK Driver
Updating the NVM with a DPDK Driver
DPDK Installation and Configuration
DPDK Installation and Configuration System Configuration BIOS Settings Hugepages Setup IOMMU CPU Isolation RCU Callbacks Tickless Kernel vt.handoff NUMA Balancing and MCE Active-State Power Management High Performance of Small Packets on 100G NIC- Use 16 Bytes Rx Descriptor Size Downloading and Installing the ice Driver Getting the Latest DPDK Code Prerequisite Library Installing DPDK Linux Drivers
System Configuration
BIOS Settings
Hugepages Setup
IOMMU
CPU Isolation
RCU Callbacks
Tickless Kernel
vt.handoff
NUMA Balancing and MCE
Active-State Power Management
High Performance of Small Packets on 100G NIC- Use 16 Bytes Rx Descriptor Size
Downloading and Installing the ice Driver
Getting the Latest DPDK Code
Prerequisite Library
Installing DPDK
Installing DPDK Using the Meson Build System (Recommended) Setting 16 Bytes Rx Descriptor Size
Installing DPDK Using the Meson Build System (Recommended)
Setting 16 Bytes Rx Descriptor Size
Linux Drivers
Linux Drivers Loading the vfio-pci Module Binding and Unbinding Network Ports
Loading the vfio-pci Module
Binding and Unbinding Network Ports
Virtual Function (VF) Setup with DPDK
Advanced Features and Debug
Q-in-Q Support Malicious Driver Detection Receive Side Scaling Configuration
Q-in-Q Support
Malicious Driver Detection
Receive Side Scaling Configuration
Test Applications (pktgen and testpmd)
Test Applications (pktgen and testpmd) Setting Up pktgen Server Setting Up Testpmd Application Example pktgen Configuration Example Testpmd Configuration Running a Sample Application L3fwd Server DPDK Test Plans
Setting Up pktgen Server
Setting Up Testpmd Application
Setting Up Testpmd Application Running Testpmd Testpmd Runtime Functions Debugging in Testpmd
Running Testpmd
Testpmd Runtime Functions
Debugging in Testpmd
Example pktgen Configuration
Example Testpmd Configuration
Running a Sample Application L3fwd Server
DPDK Test Plans

Loading the vfio-pci Module

Load the vfio-pci module with the following command:

modprobe vfio-pci

VFIO kernel is usually present by default in all distributions. If it is not, consult your distribution’s documentation for installation instructions.

To make use of full VFIO functionality, both kernel and BIOS must support and be configured to use I/O virtualization (such as Intel® VT-d).

In most cases, specifying iommu=on as kernel parameter should be enough to configure the Linux kernel to use IOMMU.

Note:VFIO no-IOMMU mode:

If there is no IOMMU available on the system, VFIO can still be used, but it must be loaded with an additional module parameter:

modprobe vfio enable_unsafe_noiommu_mode=1

Alternatively, one can also enable this option in an already loaded kernel module:

echo 1 > /sys/module/vfio/parameters/enable_unsafe_noiommu_mode

After that, VFIO can be used with hardware devices as usual.

Note that it might be required to unload all VFIO-related modules before probing the module again with the enable_​unsafe_​noiommu_​mode=1 parameter.

Warning: Since no-IOMMU mode forgoes IOMMU protection, it is inherently unsafe. That said, it does make it possible for the user to keep the degree of device access and programming that VFIO has, in situations where IOMMU is not available.

Binding and Unbinding Network Ports