4. testpmd 基础入门：启动命令、交互模式与命令行模式、端口初始化与启动

testpmd 是 DPDK 官方提供的用户态数据包转发测试工具，也是性能基准测试中最常用的流量收发与配置验证平台。本章将系统讲解 testpmd 的三种运行模式、核心启动参数、端口初始化流程以及交互式控制方法，为后续使用 pktgen 与 testpmd 联合进行性能测试打下坚实基础。

4.1 testpmd 概述与运行模式

testpmd 本质上是一个基于 DPDK 框架的以太网数据包转发应用，支持多队列、RSS、流分类、硬件卸载等特性的配置与验证。其运行模式分为以下三种：

4.2 testpmd 启动命令与核心参数

testpmd 的启动命令遵循 DPDK 应用的标准格式：EAL 参数在前，应用参数在后。以下是一个典型的启动示例：

# 基本启动命令（交互模式）
./dpdk-testpmd -l 0-3 -n 4 -- -i --portmask=0x3 --nb-cores=2

# 参数说明：
# -l 0-3          ：绑定逻辑核 0~3
# -n 4            ：每个 NUMA 节点分配 4 个内存通道
# -- -i           ：进入交互模式
# --portmask=0x3  ：启用端口 0 和端口 1
# --nb-cores=2    ：使用 2 个转发核

下表列出了 testpmd 启动时最常用的核心参数及其作用：

4.3 交互模式与常用命令

交互模式是 testpmd 最灵活的操作方式。启动后进入 testpmd> 提示符，可实时输入命令进行端口管理、转发控制、统计查看等操作。

4.3.1 端口初始化与启动

端口初始化是 testpmd 使用的基础步骤，通常包括以下操作：

# 1. 查看所有可用端口
testpmd> show port info all

# 2. 启动指定端口（端口 0 和 1）
testpmd> port start 0
testpmd> port start 1

# 3. 启动所有端口
testpmd> port start all

# 4. 停止端口
testpmd> port stop 0

# 5. 重置端口统计
testpmd> clear port stats all

4.3.2 转发控制命令

启动端口后，通过以下命令控制数据转发：

4.3.3 常用配置命令

# 设置转发模式为 io（纯 IO 转发，不修改 MAC）
testpmd> set fwd io

# 设置转发模式为 mac（修改源/目的 MAC）
testpmd> set fwd mac

# 设置每个转发核的队列数
testpmd> set rxq 4
testpmd> set txq 4

# 设置 RSS 哈希类型
testpmd> port config 0 rss all

# 查看当前配置
testpmd> show config

4.4 命令行模式与自动化

命令行模式允许将 testpmd 命令写入文件，通过 --cmdline-file 参数批量执行，适用于自动化测试场景。

# 创建命令文件 cmds.txt
cat > cmds.txt << EOF
port start all
set fwd mac
start
show fwd stats all
stop
EOF

# 以命令行模式启动
./dpdk-testpmd -l 0-3 -n 4 -- --cmdline-file=cmds.txt

4.5 端口初始化流程详解

testpmd 启动时，端口初始化经历以下关键阶段：

1. EAL 初始化： 分配大页内存、初始化 PCI 总线、绑定逻辑核。
2. 端口探测： 扫描 PCI 设备，识别绑定到 DPDK 驱动的物理端口。
3. 端口配置： 根据启动参数设置描述符环大小、队列数、卸载功能等。
4. 端口启动： 调用 rte_eth_dev_start() 使端口进入运行状态。
5. 转发线程初始化： 在每个转发核上创建转发线程，准备接收和发送数据包。

4.6 常见问题与排查