3. DPDK 环境搭建：系统要求、源码编译、内核模块加载、大页配置

DPDK 环境搭建是用户态协议栈部署的基础。本章从系统硬件与软件要求出发，逐步完成源码编译、内核模块加载与大页配置，确保后续 VPP 集成环境具备高性能数据面能力。

3.1 系统要求

3.1.1 硬件要求

3.1.2 软件要求

• 操作系统：Ubuntu 22.04 / CentOS 8 / Rocky Linux 9
• 内核版本：≥ 5.4（推荐 5.15 LTS）
• 编译器：GCC ≥ 10.3
• 构建工具：meson ≥ 0.61、ninja ≥ 1.10、pkg-config
• 依赖库：libnuma-dev、libelf-dev、python3-pip、pyelftools

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

3.2 源码编译

3.2.1 获取源码

wget https://fast.dpdk.org/rel/dpdk-22.11.tar.xz
tar xf dpdk-22.11.tar.xz
cd dpdk-22.11

3.2.2 配置与编译

DPDK 22.11 使用 meson 构建系统。推荐使用 release 模式，并启用 kmods 选项以编译内核模块。

meson setup build -Dbuildtype=release -Dexamples=all -Denable_kmods=true
ninja -C build
sudo ninja -C build install

编译完成后，DPDK 库文件安装至 /usr/local/lib/x86_64-linux-gnu/，头文件位于 /usr/local/include/dpdk/。

3.2.3 验证编译结果

ldconfig -p | grep dpdk
# 输出示例：
#   librte_eal.so.23 (libc6,x86-64) => /usr/local/lib/x86_64-linux-gnu/librte_eal.so.23

3.3 内核模块加载

DPDK 需要加载 uio 或 vfio-pci 内核模块来接管网卡。推荐使用 vfio-pci，支持更完善的 IOMMU 隔离。

3.3.1 加载 vfio-pci 模块

sudo modprobe vfio-pci
lsmod | grep vfio

若系统不支持 IOMMU，可回退至 uio_pci_generic：

sudo modprobe uio_pci_generic

3.3.2 绑定网卡到 DPDK 驱动

使用 DPDK 自带的 dpdk-devbind.py 脚本查看并绑定网卡。

# 查看当前网卡状态
python3 usertools/dpdk-devbind.py -s

# 绑定网卡 0000:02:00.0 到 vfio-pci
sudo python3 usertools/dpdk-devbind.py -b vfio-pci 0000:02:00.0

# 确认绑定成功
python3 usertools/dpdk-devbind.py -s | grep "02:00.0"

3.4 大页配置

大页（HugePages）是 DPDK 性能的核心保障，减少 TLB miss 并提升内存访问效率。DPDK 推荐使用 1 GB 大页。

3.4.1 预留 1 GB 大页

在 GRUB 内核启动参数中添加：

default_hugepagesz=1G hugepagesz=1G hugepages=4

编辑 /etc/default/grub，修改 GRUB_CMDLINE_LINUX：

GRUB_CMDLINE_LINUX="default_hugepagesz=1G hugepagesz=1G hugepages=4"

更新 GRUB 并重启：

sudo update-grub
sudo reboot

3.4.2 运行时动态分配（2 MB 大页）

若无法重启，可使用 2 MB 大页动态分配：

echo 2048 | sudo tee /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages
sudo mkdir -p /mnt/huge
sudo mount -t hugetlbfs pagesize=2M /mnt/huge

3.4.3 验证大页配置

cat /proc/meminfo | grep Huge
# 输出示例：
# AnonHugePages:         0 kB
# HugePages_Total:       4
# HugePages_Free:        4
# HugePages_Rsvd:        0
# HugePages_Surp:        0
# Hugepagesize:    1048576 kB

echo "nodev /mnt/huge hugetlbfs pagesize=1G 0 0" | sudo tee -a /etc/fstab

3.5 环境验证：DPDK 测试程序

使用 helloworld 示例验证环境完整性：

cd examples/helloworld
make
sudo ./build/helloworld -l 0-1 -n 4
# 输出示例：
# hello from core 0
# hello from core 1

若输出正常，说明 DPDK 环境搭建成功。

3.6 常见问题与排查