2. DPDK 环境搭建：系统要求、内核配置、大页内存设置、DPDK 源码编译与安装

DPDK 环境搭建是进行高性能网络开发与 Pktgen 发包测试的基础。本章将系统性地讲解从硬件选型、操作系统配置到 DPDK 源码编译的全流程，确保你能够搭建一个稳定、高效的 DPDK 运行环境。

2.1 系统要求与硬件兼容性

DPDK 对硬件和操作系统有特定要求。选择合适的硬件平台和操作系统版本，可以避免后续开发中 90% 的兼容性问题。

2.2 内核配置与启动参数

DPDK 需要内核支持 UIO（Userspace I/O）或 VFIO（Virtual Function I/O）框架。以下步骤以 Ubuntu 22.04 为例进行配置。

2.2.1 检查当前内核配置

# 检查 UIO 模块是否已加载
lsmod | grep uio

# 检查 VFIO 模块是否已加载
lsmod | grep vfio

# 查看内核启动参数
cat /proc/cmdline

2.2.2 修改 GRUB 启动参数

编辑 /etc/default/grub 文件，在 GRUB_CMDLINE_LINUX 中添加以下参数：

# 默认参数示例
GRUB_CMDLINE_LINUX="default_hugepagesz=1G hugepagesz=1G hugepages=4 iommu=pt intel_iommu=on"

# 参数说明：
# default_hugepagesz=1G   : 设置默认大页大小为 1G
# hugepagesz=1G           : 启用 1G 大页支持
# hugepages=4             : 预留 4 个 1G 大页（共 4GB）
# iommu=pt                : 启用 IOMMU 直通模式
# intel_iommu=on          : 开启 Intel VT-d 支持

更新 GRUB 配置并重启：

sudo update-grub
sudo reboot

2.3 大页内存设置

大页内存是 DPDK 性能的关键。DPDK 通过预留大页来减少 TLB 缺失，提升数据包处理效率。以下是两种常用的大页配置方式。

2.3.1 运行时动态配置（推荐）

# 配置 2MB 大页（共 2048 个，约 4GB）
echo 2048 | sudo tee /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages

# 挂载大页文件系统
sudo mkdir -p /mnt/huge
sudo mount -t hugetlbfs nodev /mnt/huge

# 持久化配置（写入 /etc/fstab）
echo "nodev /mnt/huge hugetlbfs defaults 0 0" | sudo tee -a /etc/fstab

2.3.2 通过 GRUB 静态配置（1G 大页）

如 2.2.2 节所示，在 GRUB 中配置 1G 大页后，重启即可生效。验证方式：

# 查看大页使用情况
cat /proc/meminfo | grep Huge

# 输出示例：
# AnonHugePages:         0 kB
# ShmemHugePages:        0 kB
# HugePages_Total:       4
# HugePages_Free:        4
# HugePages_Rsvd:        0
# HugePages_Surp:        0
# Hugepagesize:       1048576 kB

2.4 DPDK 源码编译与安装

本节将指导你从 DPDK 官方仓库下载源码，并完成编译安装。我们以 DPDK 23.11 LTS 版本为例。

2.4.1 下载与解压

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

# 解压
tar -xvf dpdk-23.11.tar.xz
cd dpdk-23.11

2.4.2 编译配置

DPDK 使用 meson 和 ninja 构建系统。首先安装依赖：

# Ubuntu 依赖安装
sudo apt update
sudo apt install -y meson ninja-build pkg-config libnuma-dev python3-pip

# 配置编译选项
meson setup build

# 常用配置选项（可选）
meson configure build -Dexamples=all -Denable_kmods=true

2.4.3 编译与安装

# 编译
ninja -C build

# 安装到系统目录
sudo ninja -C build install

# 更新动态链接库缓存
sudo ldconfig

2.5 环境配置与驱动绑定

DPDK 安装完成后，需要加载内核模块并绑定网卡到 DPDK 驱动。

2.5.1 加载内核模块

# 加载 UIO 模块
sudo modprobe uio_pci_generic

# 或加载 VFIO 模块（推荐）
sudo modprobe vfio-pci

# 加载 igb_uio 模块（需单独编译）
sudo modprobe igb_uio

2.5.2 绑定网卡到 DPDK 驱动

使用 DPDK 自带的 dpdk-devbind.py 脚本进行绑定：

# 查看当前网卡状态
sudo dpdk-devbind.py -s

# 绑定网卡（以 0000:02:00.0 为例）
sudo dpdk-devbind.py -b vfio-pci 0000:02:00.0

# 验证绑定结果
sudo dpdk-devbind.py -s

2.6 环境验证：运行 helloworld 示例

编译并运行 DPDK 自带的 helloworld 示例，验证环境是否正常工作。

# 编译 helloworld 示例
cd dpdk-23.11/examples/helloworld
make

# 运行（指定大页内存和核数）
sudo ./build/helloworld -l 0-1 -n 4

# 预期输出：
# hello from core 0
# hello from core 1

2.7 环境搭建全流程总结

以下 SVG 图展示了 DPDK 环境搭建的完整流程与各组件之间的关系：

2.8 常见问题与排错