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

Configuration Guide

Download as PDF
ID 764257
Date 06/16/2023
Version 22.11
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
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)

Running Testpmd

When running testpmd there are two distinct parts to the command-line options – the first half are the EAL parameters, followed by the testpmd command-line options as the second half. These sections are separated in the command with a -- separator.

For example, a simple command to start testpmd looks like:

./dpdk-testpmd -a 00:01.0 -- -i

This command explicitly passes in the PCI device located at BDF number 00:01.0 with the -a flag in the EAL section of the command. Then the -i flag in the testpmd section starts the application in interactive mode.

For more details on the role of EAL, see the DPDK Overview.

Common Command-line Options

This section lists several common flags for EAL parameters and testpmd parameters. These commands are intended to provide a starting place when learning the application. Several of these flags have more details available on dpdk.org. See Example Testpmd Configuration for an extended example of running testpmd.

Some common flags for EAL parameters include:

  • -a, --allow <[domain:]bus:devid.func>: Add a PCI device in to the list of devices to probe.
  • -n <number of channels>: Set the number of memory channels to use.
  • -l <core list>: List of cores to run on, where - is used as a range separator and , is used as a single number separator.
  • --socket-mem <amounts of memory per socket>: Preallocate specified amounts of memory per socket. The parameter is a comma-separated list of values.

For a complete list of EAL parameters, see dpdk.org:

https://doc.dpdk.org/guides/linux_gsg/linux_eal_parameters.html

Some common flags for testpmd options include:

  • -i, --interactive: Start testpmd with an interactive prompt. See Testpmd Runtime Functions for more details.
  • --rxq=N: Set number of RX queues per port to N.
  • --txq=N: Set number of TX queues per port to N.
  • --nb-cores=N: Set number of forwarding cores.
  • --forward-mode=mode: Set forwarding to a specific mode such as mac, rxonly, ieee1588, noisy, etc. The default mode is io.

For a complete list of testpmd command-line options, see dpdk.org:

https://doc.dpdk.org/guides/testpmd_app_ug/run_app.html

Testpmd Runtime Functions