1. testpmd 概述与环境搭建

testpmd 是 DPDK 官方提供的交互式数据包转发测试工具，也是网络功能开发与性能调优中最常用的调试入口。它支持多种转发模式（I/O 转发、流规则转发、精确匹配转发），能够直接操作网卡的流表（RTE Flow）、队列（RX/TX Queue）、描述符环（Ring）以及硬件卸载（Offload）能力。在丢包分析场景中，testpmd 可以快速验证流规则是否生效、观察收发包计数、统计丢包位置，是定位性能瓶颈的核心手段。

1.1 DPDK 版本选择与 testpmd 编译安装

1.1.1 版本选择原则

DPDK 每半年发布一个 LTS（长期支持）版本，非 LTS 版本每季度发布。对于生产级调试环境，推荐使用最新的 LTS 版本，以获得稳定的 API 和长期安全更新。下表列出当前主流版本对比：

1.1.2 编译安装 testpmd

testpmd 是 DPDK 示例应用之一，编译 DPDK 时会自动生成。以下为完整编译步骤：

1. 下载源码：从 DPDK 官方 Git 仓库或发布页面获取 23.11 LTS 源码。
2. 安装依赖：确保系统已安装 meson、ninja、pkg-config、libnuma-dev、python3-pyelftools 等构建工具。
3. 配置与编译：使用 meson 构建系统，指定安装路径和目标架构。
4. 验证 testpmd：编译完成后，testpmd 二进制位于 build/app/dpdk-testpmd。

# 下载 DPDK 23.11 LTS
wget https://fast.dpdk.org/rel/dpdk-23.11.tar.xz
tar xf dpdk-23.11.tar.xz
cd dpdk-23.11

# 安装必要依赖（Ubuntu 22.04 示例）
sudo apt-get update
sudo apt-get install -y meson ninja-build pkg-config libnuma-dev python3-pyelftools

# 配置构建
meson setup build -Dexamples=all -Denable_kmods=true

# 编译
ninja -C build

# 验证 testpmd 是否生成
ls -l build/app/dpdk-testpmd

1.2 大页内存配置

DPDK 通过大页（HugePages）减少 TLB 缺失，提升数据包处理性能。testpmd 在启动时会从大页池中分配内存池（mempool），因此大页配置是环境搭建的关键步骤。

1.2.1 大页配置参数

1.2.2 配置步骤

1. 分配大页：通过内核启动参数或运行时写入 /sys/kernel/mm/hugepages。
2. 挂载 hugetlbfs：使 DPDK 能通过文件系统访问大页。
3. 验证配置：检查大页分配是否成功，以及可用大页数量。

# 运行时分配 4096 个 2MB 大页（适用于 NUMA 节点 0）
echo 4096 | sudo tee /sys/devices/system/node/node0/hugepages/hugepages-2048kB/nr_hugepages

# 挂载 hugetlbfs
sudo mkdir -p /mnt/huge
sudo mount -t hugetlbfs nodev /mnt/huge

# 验证大页分配
cat /proc/meminfo | grep HugePages
# 输出示例：HugePages_Total:    4096

1.3 UIO 驱动绑定

DPDK 需要将网卡从内核原生驱动（如 ixgbe、i40e、mlx5_core）解绑，并绑定到 DPDK 兼容的 UIO（Userspace I/O）驱动或 VFIO 驱动。testpmd 通过 UIO 驱动直接访问网卡寄存器与 DMA 内存，实现零拷贝数据收发。

1.3.1 驱动类型对比

1.3.2 绑定步骤（以 igb_uio 为例）

1. 加载 UIO 模块：使用 modprobe 加载 uio 和 igb_uio。
2. 查找网卡 PCI 地址：使用 lspci 或 DPDK 的 dpdk-devbind.py 脚本。
3. 解绑原生驱动：将网卡从内核驱动解绑。
4. 绑定 UIO 驱动：将网卡绑定到 igb_uio。
5. 验证绑定状态：确认网卡已处于 DPDK 接管状态。

# 加载 igb_uio 模块
sudo modprobe uio
sudo insmod build/kernel/linux/igb_uio/igb_uio.ko

# 查看网卡 PCI 地址（以 0000:02:00.0 为例）
lspci | grep Ethernet
# 输出示例：02:00.0 Ethernet controller: Intel Corporation Ethernet Controller XXV710

# 使用 dpdk-devbind.py 绑定
sudo ./usertools/dpdk-devbind.py -b igb_uio 0000:02:00.0

# 验证绑定
sudo ./usertools/dpdk-devbind.py -s
# 输出示例：
# Network devices using DPDK-compatible driver
# ============================================
# 0000:02:00.0 'Ethernet Controller XXV710' drv=igb_uio unused=

1.4 环境验证：启动 testpmd

完成大页配置和驱动绑定后，启动 testpmd 验证环境是否就绪。以下命令启动一个基本的 2 队列转发测试：

sudo ./build/app/dpdk-testpmd -l 0-3 -n 4 -- -i --portmask=0x1 --rxq=2 --txq=2

# 参数说明：
# -l 0-3        ：使用 CPU 核心 0-3
# -n 4          ：每个 NUMA 节点分配 4 个内存通道
# -- -i         ：进入交互模式
# --portmask=0x1：仅使用端口 0
# --rxq=2 --txq=2：每个端口 2 个 RX/TX 队列

如果启动成功，testpmd 命令行提示符 testpmd> 会出现。此时可以输入 show port stats all 查看端口统计，或 start 开始转发。

1.5 本章知识结构图

下图总结了 testpmd 环境搭建的完整流程与各组件之间的关系：

1.6 常见问题与排查