2. 环境搭建与编译：DPDK源码获取、依赖安装、meson/ninja编译配置、大页内存配置、VFIO/uio驱动绑定

本章将带领你从零搭建一套可运行的DPDK开发环境。环境搭建是后续所有性能实验的基础，错误的配置会导致性能骤降甚至功能异常。我们将依次完成：源码获取、系统依赖安装、Meson/Ninja编译系统配置、大页内存（Hugepages）配置以及网卡驱动绑定（VFIO/UIO）。

2.1 DPDK源码获取

DPDK官方源码托管在 dpdk.org/git/dpdk 和 GitHub。推荐使用git克隆，便于后续版本切换和补丁管理。

# 克隆最新LTS版本（以23.11为例）
git clone https://github.com/DPDK/dpdk.git -b v23.11
cd dpdk

# 查看所有可用分支和标签
git branch -a
git tag | grep 23.11

源码目录结构核心组件说明：

2.2 系统依赖安装

DPDK编译需要一系列系统库和工具。以下为Ubuntu和CentOS的依赖安装命令：

# Ubuntu 22.04
sudo apt update
sudo apt install -y build-essential meson ninja-build \
    python3-pyelftools libnuma-dev libpcap-dev \
    libssl-dev libelf-dev pkg-config

# CentOS Stream 9
sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y meson ninja-build python3-pyelftools \
    numactl-devel libpcap-devel openssl-devel \
    elfutils-libelf-devel pkgconfig

关键依赖作用速查表：

2.3 Meson/Ninja编译配置

DPDK从20.11版本起全面采用Meson构建系统。Meson负责配置项目选项，Ninja负责并行编译。配置流程如下：

# 进入DPDK源码根目录
cd dpdk

# 配置构建目录（build），指定安装路径
meson setup build --prefix=/usr/local/dpdk

# 常用配置选项（可选）
meson configure build -Dexamples=l2fwd,l3fwd
meson configure build -Denable_docs=false
meson configure build -Dmachine=default  # 或 native 启用CPU特定优化

# 查看所有可配置选项
meson configure build

关键配置选项说明：

# 编译（使用所有CPU核心）
ninja -C build -j$(nproc)

# 安装到指定前缀目录
sudo ninja -C build install

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

编译成功后，关键输出文件：

• build/lib/librte_eal.so — 环境抽象层动态库
• build/lib/librte_mempool.so — 内存池库
• build/lib/librte_mbuf.so — mbuf库
• build/app/dpdk-testpmd — 测试PMD应用
• build/examples/dpdk-l2fwd — 二层转发示例

2.4 大页内存配置

DPDK通过大页内存（Hugepages）减少TLB miss，是零拷贝性能的关键。大页内存必须在系统启动时或运行时预留，且不能被普通进程占用。

2.4.1 运行时配置（推荐开发环境）

# 预留 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
# 输出示例: HugePages_Total:    1024

2.4.2 持久化配置（推荐生产环境）

# 编辑 /etc/default/grub，在 GRUB_CMDLINE_LINUX 中添加：
# default_hugepagesz=1G hugepagesz=1G hugepages=4

# 更新grub并重启
sudo update-grub
sudo reboot

# 重启后验证
grep HugePages_Total /proc/meminfo
# 输出示例: HugePages_Total:       4

大页配置参数对比：

2.5 VFIO/UIO驱动绑定

DPDK需要将网卡从内核驱动（如igb、ixgbe、i40e）解绑，绑定到用户态驱动（VFIO或UIO），才能实现零拷贝数据收发。

2.5.1 驱动选择对比

2.5.2 使用dpdk-devbind.py绑定网卡

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

# 示例输出：
# Network devices using kernel driver
# 0000:02:00.0 'Ethernet Controller X710' if=ens2f0 drv=i40e

# 绑定到 vfio-pci（推荐）
sudo modprobe vfio-pci
sudo ./usertools/dpdk-devbind.py -b vfio-pci 0000:02:00.0

# 绑定到 igb_uio（备选）
sudo modprobe uio
sudo insmod build/kernel/linux/igb_uio/igb_uio.ko
sudo ./usertools/dpdk-devbind.py -b igb_uio 0000:02:00.0

# 验证绑定结果
./usertools/dpdk-devbind.py --status
# 输出应显示：Network devices using DPDK-compatible driver

2.5.3 VFIO额外配置（IOMMU）

# 检查IOMMU是否启用
dmesg | grep -i iommu

# 如果未启用，在grub中添加：
# intel_iommu=on iommu=pt

# 允许非特权用户使用VFIO（可选）
sudo chmod 666 /dev/vfio/vfio

2.6 环境验证

完成上述所有步骤后，使用DPDK自带的 helloworld 示例验证环境是否正常：

# 编译helloworld示例（如果之前未编译）
meson configure build -Dexamples=helloworld
ninja -C build

# 运行（需要root权限）
sudo build/examples/dpdk-helloworld -l 0-1

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

如果看到每个核心打印一行"hello from core X"，说明环境搭建成功。如果出现错误，请按以下顺序排查：

1. 大页内存：检查 /proc/meminfo 中 HugePages_Total 是否 > 0
2. 驱动绑定：运行 dpdk-devbind.py --status 确认网卡已绑定到vfio-pci或igb_uio
3. 权限：确保以root运行，或已配置 /dev/vfio/vfio 权限
4. 内核模块：检查 lsmod | grep vfio 或 lsmod | grep uio