📚 课程目录第1章环境搭建与初识DPDK

1. 环境搭建与初识DPDK

任务目标

在Linux系统上完成DPDK环境搭建，运行官方helloworld示例，通过观察输出与初始化流程，理解DPDK的基本架构（EAL层、内存池、网卡驱动）及rte_eal_init()为核心的启动过程。

环境依赖

Linux发行版（Ubuntu 20.04+/CentOS 8+），内核≥3.10
编译器：gcc、make、pkg-config
Python 3.6+（用于DPDK构建脚本）
可选：libnuma-dev（NUMA支持）、libelf-dev

安装与配置步骤

下载DPDK源码（以22.11 LTS为例）：wget https://fast.dpdk.org/rel/dpdk-22.11.tar.xz 并解压。
进入源码目录，执行 meson setup build 配置构建（需meson与ninja，可用pip安装）。
执行 ninja -C build 编译，然后 sudo ninja -C build install 安装。
配置HugePages（DPDK依赖大页内存）：
echo 1024 | sudo tee /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages
并挂载：sudo mkdir -p /mnt/huge && sudo mount -t hugetlbfs pagesize=2MB /mnt/huge
加载内核模块：sudo modprobe vfio-pci（或igb_uio，取决于驱动模式）。

关键完整代码：helloworld示例

以下代码位于 examples/helloworld/main.c，是DPDK最小可运行示例，展示EAL初始化与lcore并发执行模型：

/* SPDX-License-Identifier: BSD-3-Clause */
#include <rte_eal.h>
#include <rte_lcore.h>
#include <stdio.h>
#include <stdint.h>

/* 每个lcore上执行的入口函数 */
static int lcore_hello(__rte_unused void *arg)
{
    unsigned lcore_id = rte_lcore_id();
    printf("hello from core %u\n", lcore_id);
    return 0;
}

int main(int argc, char **argv)
{
    int ret = rte_eal_init(argc, argv);
    if (ret < 0)
        rte_exit(EXIT_FAILURE, "EAL init failed\n");

    /* argc/argv已由EAL消费，ret为已解析参数个数 */
    argc -= ret;
    argv += ret;

    /* 在所有在线lcore上广播执行 */
    RTE_LCORE_FOREACH_WORKER(lcore_id) {
        rte_eal_remote_launch(lcore_hello, NULL, lcore_id);
    }

    /* 主核也执行一次 */
    lcore_hello(NULL);

    /* 等待所有从核完成 */
    RTE_LCORE_FOREACH_WORKER(lcore_id) {
        rte_eal_wait_lcore(lcore_id);
    }

    rte_eal_cleanup();
    return 0;
}

编译与运行

# 在DPDK源码examples/helloworld目录下
make
# 以root运行（需大页内存权限）
sudo ./build/helloworld -l 0-3

验证方法与通过标准

预期输出（确定性结果）：程序打印4行（-l 0-3指定4个核），每行格式为 hello from core N，其中N为0、1、2、3（顺序可能因调度而异）。
判定通过：所有指定lcore均打印hello信息，且进程正常退出（exit code 0），无EAL初始化错误或内存分配失败提示。
附加检查：运行 sudo ./build/helloworld -l 0-1 --log-level=lib.eal:debug 可观察EAL初始化详细日志，确认hugepage映射、内存段初始化等步骤成功执行。

DPDK初始化流程要点

helloworld的核心是rte_eal_init()，它完成：环境抽象层初始化（解析EAL参数、配置lcore）、内存子系统初始化（映射hugepages、创建内存段）、PCI设备探测（若绑定驱动则枚举网卡）、以及日志与定时器子系统启动。理解此函数即掌握DPDK启动骨架，后续所有DPDK程序均复用此流程。

常见问题排查

EAL初始化失败提示hugepage不足：检查 /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages 是否已设置，或运行 sudo sysctl vm.nr_hugepages=1024。
无法绑定网卡（本示例不需要）：helloworld不涉及网卡，若后续实验需要，用 dpdk-devbind.py 绑定VFIO驱动。
编译报错找不到rte_eal.h：确认已执行 ninja install，且pkg-config路径正确（export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig）。