4. DPDK环境搭建与第一个转发程序

DPDK 的学习不能停留在概念层面，必须先把“能跑起来”这件事做扎实。本节围绕一条完整链路展开：从源码编译 DPDK，到用 dpdk-devbind.py 把物理网卡从内核驱动解绑并交给 vfio-pci，再到运行 l2fwd 与 l3fwd 两个经典转发程序，最后通过性能计数器判断转发是否真正达到预期。整个过程的核心矛盾只有一个：让用户态程序绕过内核网络协议栈，直接接管网卡的收发队列。

一、编译 DPDK：从源码到可用库

推荐使用源码编译而非发行版包，因为需要精确控制编译选项和驱动支持。以 DPDK 22.11 LTS 为例，先安装依赖：

sudo apt install -y build-essential meson ninja-build python3-pip \
  libnuma-dev pkg-config libibverbs-dev
pip3 install pyelftools

DPDK 使用 Meson + Ninja 构建系统。进入源码目录后执行：

meson setup build -Dbuildtype=release -Dmachine=native \
  -Dexamples=l2fwd,l3fwd
ninja -C build

这里有两个关键点。-Dbuildtype=release 开启 -O3 优化，对转发性能影响显著；-Dmachine=native 让编译器针对当前 CPU 生成指令，能启用 AVX-512 等向量化能力。编译完成后，build/app/ 下会生成 dpdk-l2fwd、dpdk-l3fwd，build/lib/ 下是共享库。为了让程序找到库，需要设置环境变量：

export RTE_SDK=$(pwd)
export RTE_TARGET=build
export LD_LIBRARY_PATH=$RTE_SDK/$RTE_TARGET/lib:$LD_LIBRARY_PATH

随后用 ./build/app/dpdk-l2fwd --version 验证，能打印版本号即编译成功。

二、绑定网卡：把设备交给用户态驱动

DPDK 不能直接使用内核驱动管理的网卡。必须先把网卡从内核驱动解绑，再绑定到 vfio-pci（或 uio_pci_generic）。先确认 IOMMU 已开启：

# 内核启动参数需包含
intel_iommu=on iommu=pt
# 检查
dmesg | grep -i iommu

然后加载 VFIO 模块并查看网卡 PCI 地址：

sudo modprobe vfio-pci
./usertools/dpdk-devbind.py --status

输出中会列出 Network devices using kernel driver，例如 0000:03:00.0 使用 ixgbe。执行绑定：

sudo ifconfig enp3s0 down
sudo ./usertools/dpdk-devbind.py --bind=vfio-pci 0000:03:00.0

再次 --status，该设备应出现在 Network devices using DPDK-compatible driver 下。这一步是后续所有程序的前提，绑定失败通常意味着 IOMMU 未开或设备仍被内核占用。

三、运行 l2fwd：二层转发的第一个闭环

l2fwd 是最简单的转发程序：从每个端口收包，交换源/目的 MAC 后从另一个端口发出。启动命令如下：

sudo ./build/app/dpdk-l2fwd -l 0-1 -n 4 -- -p 0x3 -q 1

参数含义：-l 0-1 指定使用 CPU 核 0 和 1；-n 4 表示内存通道数；-- 之后是应用参数，-p 0x3 表示启用端口 0 和 1（二进制 11），-q 1 表示每端口 1 个收发队列。程序启动后会打印每个端口的 MAC 地址和队列映射，随后进入无限轮询循环。

此时用另一台机器或打流仪向端口 0 发送流量，端口 1 应能收到转发后的报文。若没有任何输出，先检查网卡是否已绑定到 vfio-pci，以及 -p 的端口掩码是否与实际端口对应。

四、运行 l3fwd：三层转发与查表

l3fwd 比 l2fwd 多了一步路由查表，需要提供路由表配置。典型启动方式：

sudo ./build/app/dpdk-l3fwd -l 0-3 -n 4 -- \
  -p 0x3 --config="(0,0,0),(1,0,1)" \
  --parse-ptype

--config 的格式为 (端口, 队列, 核)，这里把端口 0 的队列 0 绑到核 0，端口 1 的队列 0 绑到核 1。--parse-ptype 让程序解析报文类型以决定 IPv4/IPv6 处理路径。l3fwd 默认使用内置的 LPM 路由表，也可以通过 --lpm 或 --em 选择查表算法。运行后同样需要配置对端 IP 和路由，才能观察到转发效果。

五、分析性能计数器：判断转发是否达标

DPDK 通过 rte_eth_stats_get() 获取每端口统计。l2fwd/l3fwd 默认每秒打印一次，输出形如：

Port 0: RX 1482301 pps, TX 1482298 pps, dropped 0
Port 1: RX 1482298 pps, TX 1482301 pps, dropped 0

需要重点关注的字段有四个：ipackets（收包总数）、opackets（发包总数）、imissed（RX 队列满导致的丢包）、ierrors/oerrors（硬件错误）。判断逻辑是：opackets 应接近 ipackets，imissed 应接近 0。如果 imissed 持续增长，说明收包速度超过了应用处理速度，可能是绑定的核太少、队列太浅，或单核处理能力不足。如果 ierrors 增长，则要检查链路、光模块或线缆。

还可以用 --stats-period 调整打印间隔，或结合 dpdk-proc-info 查看更细的 xstats。对于 l3fwd，若路由表未命中，报文会被丢弃，此时 opackets 会明显低于 ipackets，需要检查路由配置。

完成以上步骤后，你就拥有了一个可运行、可观测的 DPDK 转发环境。后续所有性能优化和程序开发，都可以在这个基础上展开。