2. DPDK 环境搭建：从依赖到内核模块加载

DPDK 的高性能数据包处理能力依赖于一套精心配置的运行时环境。本章将引导你在 Ubuntu 或 CentOS 系统上，完成从安装系统依赖、编译 DPDK 源码、配置大页内存到加载内核模块的完整流程。这是后续所有实验和开发的基础，每一步的准确性都直接影响 DPDK 应用的稳定性与性能。

2.1 安装系统依赖与工具链

DPDK 编译需要完整的 C 编译环境、内核头文件以及若干辅助工具。以下表格列出了两个主流发行版所需的核心依赖包。

Ubuntu 安装命令示例：

sudo apt update
sudo apt install -y build-essential linux-headers-$(uname -r) \
                    libnuma-dev pkg-config python3 python3-pip \
                    meson ninja-build

CentOS 安装命令示例：

sudo yum groupinstall -y "Development Tools"
sudo yum install -y kernel-devel numactl-devel pkgconfig \
                    python3 python3-pip meson ninja-build

2.2 编译 DPDK 源码

DPDK 从 20.11 版本开始，推荐使用 Meson 和 Ninja 作为构建系统。相比传统的 make 方式，Meson 提供了更快的配置速度和更清晰的依赖管理。

以下是编译 DPDK 的标准流程：

1. 下载源码：从 DPDK 官方仓库或发布页面获取源码包。
2. 配置构建：使用 meson setup 指定安装路径和编译选项。
3. 编译：使用 ninja 执行并行编译。
4. 安装：将编译产物安装到系统目录。

编译与安装命令：

# 解压并进入源码目录
tar xf dpdk-21.11.tar.xz
cd dpdk-21.11

# 配置构建，指定安装到 /usr/local
meson setup build --prefix=/usr/local

# 编译（-j 参数根据 CPU 核心数调整）
ninja -C build -j $(nproc)

# 安装
sudo ninja -C build install

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

编译完成后，关键文件分布如下：

• 库文件：/usr/local/lib/x86_64-linux-gnu/ 或 /usr/local/lib64/
• 头文件：/usr/local/include/dpdk/
• 工具与脚本：/usr/local/bin/（如 dpdk-devbind.py）
• 内核模块源码：/usr/local/share/dpdk/kernel/

2.3 配置大页内存（Hugepages）

大页内存是 DPDK 性能的核心基石。它通过减少 TLB（Translation Lookaside Buffer）缺失，显著降低内存访问延迟。DPDK 通常使用 2MB 或 1GB 的大页。

以下 SVG 图展示了 DPDK 应用通过大页内存绕过传统内核页表，直接访问物理内存的架构优势。

配置 2MB 大页（推荐用于开发和测试）：

# 临时分配 1024 个 2MB 大页（总计 2GB）
echo 1024 | sudo tee /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages

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

# 验证分配是否成功
grep HugePages_Total /proc/meminfo

永久配置（重启后生效）：

编辑 /etc/default/grub，在 GRUB_CMDLINE_LINUX 中添加：

default_hugepagesz=1G hugepagesz=1G hugepages=4

然后更新 GRUB 并重启：

sudo update-grub   # Ubuntu
sudo grub2-mkconfig -o /boot/grub2/grub.cfg   # CentOS
sudo reboot

2.4 加载 UIO / IGB_UIO / VFIO 内核模块

DPDK 需要将网卡从内核驱动绑定到用户态驱动。这通过加载特定的内核模块来实现。目前主要有三种选择：UIO（通用）、igb_uio（DPDK 提供）和 VFIO（现代推荐）。

加载 igb_uio 模块（需先编译）：

# 进入 DPDK 内核模块源码目录
cd /usr/local/share/dpdk/kernel/linux/igb_uio

# 编译模块
make

# 加载模块
sudo modprobe uio
sudo insmod igb_uio.ko

# 验证模块是否加载
lsmod | grep igb_uio

加载 vfio-pci 模块（推荐生产环境）：

# 确保 IOMMU 已开启（BIOS 中启用 VT-d/AMD-Vi，内核参数添加 iommu=pt）
sudo modprobe vfio-pci

# 验证
lsmod | grep vfio

绑定网卡到 DPDK 驱动：

使用 DPDK 提供的 dpdk-devbind.py 脚本：

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

# 将 0000:02:00.0 网卡绑定到 igb_uio
sudo dpdk-devbind.py --bind=igb_uio 0000:02:00.0

# 绑定到 vfio-pci
sudo dpdk-devbind.py --bind=vfio-pci 0000:02:00.0

# 恢复网卡到内核驱动（如 ixgbe）
sudo dpdk-devbind.py --bind=ixgbe 0000:02:00.0

2.5 环境验证与常见问题

完成上述步骤后，运行 DPDK 自带的 helloworld 示例程序，验证环境是否搭建成功：

# 编译示例程序（如果之前未编译）
cd /path/to/dpdk/build/examples
ninja

# 运行 helloworld
sudo ./dpdk-helloworld -l 0-1 -n 2

如果看到类似 hello from core 0 和 hello from core 1 的输出，说明环境搭建成功。

常见问题排查：

• EAL: Cannot open /dev/igb_uio：未加载 igb_uio 模块或模块加载失败。检查 dmesg 输出。
• EAL: No free hugepages reported：大页内存未正确分配。检查 /proc/meminfo 中的 HugePages_Total 值。
• EAL: PCI device 0000:02:00.0 is not supported：网卡未被 DPDK 驱动绑定。使用 dpdk-devbind.py --status 确认网卡驱动状态。
• VFIO 绑定失败：确认 IOMMU 已开启，且用户有权限访问 /dev/vfio/vfio（通常需要 root 或加入 vfio 用户组）。