ebpf-docs libxdp 教程:XDP 程序加载、Dispatcher 与 AF_XDP Socket 管理完整指南
ebpf-docs libxdp 教程:XDP 程序加载、Dispatcher 与 AF_XDP Socket 管理完整指南
📚 ebpf-docs 是一个致力于"全面文档化 eBPF"的开源项目,本教程带你快速掌握其中的 libxdp 教程:如何加载 XDP 程序、用 Dispatcher 在单网卡上运行多个 XDP 程序,以及完成 AF_XDP Socket 管理——从 UMEM 创建到环形缓冲区收发包,一篇读懂。
什么是 libxdp?
libxdp 是一个轻量级 eBPF 库,专为 XDP 程序 提供了两大核心能力:
- 🎯 多程序管理:借助
freplace机制,通过一个"Dispatcher(调度器)"程序在单个网卡上加载并链式调用多个 XDP 程序; - ⚡ AF_XDP 支持:封装了 AF_XDP Socket 的创建、UMEM 内存配置与高速收发函数(该功能自 libbpf 1.0 起已完全迁移到 libxdp)。
XDP(Express Data Path)程序挂载在网卡收包路径的最前端,在内存分配之前就处理数据包,因此特别适合 DDoS 防护、负载均衡、高吞吐包过滤等场景。
libxdp 的完整概念文档见 libxdp.md,全部 40+ 个 API 的索引见 SUMMARY.md。
XDP 程序加载:六步从 ELF 到网卡
新手最常问的问题是:"编译好的 XDP 程序(.o 文件)怎么装到网卡上?" libxdp 提供了一组 xdp_program__* 加载函数:
| 场景 | 函数 | 说明 |
|---|---|---|
| 从 ELF 文件打开 | xdp_program__open_file |
最常用的加载入口,可指定 section 名 |
| 按路径查找 | xdp_program__find_file |
默认在 /usr/lib/bpf 搜索(可用 LIBXDP_OBJECT_PATH 覆盖) |
| 从已加载对象获取 | xdp_program__from_bpf_obj |
从 bpf_object 中取出程序 |
| 从文件描述符 | xdp_program__from_fd |
复用已打开的 fd |
| 从内核程序 ID | xdp_program__from_id |
按 prog ID 定位 |
| 从 pin 恢复 | xdp_program__from_pin |
从 bpffs 固定点恢复 |
加载之后,libxdp 会自动完成 attach 到网卡的流程;如果内核支持多程序特性且只有一个程序,它会退化为"单程序直接加载",无需 Dispatcher。
Dispatcher 多程序调度:优先级与链式调用 🎛️
要在同一张网卡上跑多个非 offload 的 XDP 程序(比如一个 DDoS 过滤器 + 一个流量统计器),libxdp 会插入一个 Dispatcher 程序作为统一入口,按顺序调用各个"组件程序"。它的关键规则有两条:
- 优先级(Priority):程序按 priority 从小到大排序执行,默认值为 50;
- 链式调用动作(Chain call action):程序必须返回"链式动作"(如
XDP_PASS、XDP_DROP)才允许继续执行下一个程序,否则处理链立即终止。默认链式动作为XDP_PASS。
用 metadata 控制执行顺序
组件程序的优先级和链式行为可以在 eBPF 侧通过 metadata 声明(来自 libxdp.md):
struct {
__uint(priority, 10); // 优先级
__uint(XDP_PASS, 1); // 允许链式调用的动作
} XDP_RUN_CONFIG(my_xdp_func);
也可以在用户态通过 xdp_program__set_run_prio 和 xdp_program__set_chain_call_enabled 设置(⚠️ 注意:必须在 attach 之前修改,否则不生效)。
Dispatcher 的 pinning 机制
内核在组件程序失去最后一个引用时会自动将其从 Dispatcher 摘除。为防止这种情况,libxdp 会在 attach 前把组件程序 pin 到 bpffs(BPF 文件系统),路径形如:
/sys/fs/bpf/xdp/dispatch-IFINDEX-DID:Dispatcher 程序本体…/prog0-prog、…/prog0-link:组件程序 0 的引用与 bpf_link 引用
一个 Dispatcher 最多挂载 10 个组件程序。相关查询接口包括 xdp_multiprog__get_from_ifindex(按网卡获取现有 Dispatcher)和 xdp_multiprog__detach 等。
💡 小贴士:可用 LIBXDP_BPFFS 环境变量覆盖 bpffs 挂载点;若未挂载 bpffs,可设置 LIBXDP_BPFFS_AUTOMOUNT=1 让 libxdp 自动挂载。
AF_XDP Socket 管理:控制面四步走 🧩
AF_XDP(XSK,XDP Socket)让数据包绕过内核网络栈直接进入用户态,是自定义协议、DDoS 深度检测等场景的高性能通道。libxdp 把繁琐的内核细节封装成两类 API:
第一步:创建 UMEM 内存区
UMEM 是存放所有收/发包数据的用户态内存区,可视为一个大 chunk 数组。核心函数:
xsk_umem__create:分配并注册 UMEM(推荐 chunk_size 为 2048~4096,chunk 数量 4096 左右)xsk_umem__delete/xsk_umem__fd:释放与取 fdxsk_umem__get_data:由描述符索引取出包数据指针
第二步:创建并关联 Socket
UMEM 就绪后,创建与之关联的 AF_XDP Socket:
xsk_socket__create:Socket 独占 UMEM(单队列场景)xsk_socket__create_shared:共享 UMEM(多队列/多线程场景)xsk_socket__delete/xsk_socket__fd:删除与取 fd
第三步:加载并绑定 XDP 程序
用 xsk_setup_xdp_prog 把 XDP 程序挂到网卡上;若网卡已有程序,libxdp 会尝试替换。
第四步:更新 XSKMAP
通过 xsk_socket__update_xskmap 把 Socket 注册进 XSKMAP——XDP 程序正是靠这张 map 把数据包重定向到正确的用户态 Socket。
数据面:四种环形缓冲区高效收发 🔁
AF_XDP 的数据面由 4 个 FIFO 环形缓冲区组成,libxdp 全部以 static inline 函数形式提供:
| 环 | 类型 | 作用 | 核心函数 |
|---|---|---|---|
| Fill 环 | 生产者 | 向内核提供空闲 buffer | xsk_ring_prod__reserve → fill_addr → submit |
| TX 环 | 生产者 | 发送数据包 | xsk_ring_prod__tx_desc、needs_wakeup |
| RX 环 | 消费者 | 从内核接收数据包 | xsk_ring_cons__peek → rx_desc → release |
| Completion 环 | 消费者 | 确认已发送包的完成 | xsk_ring_cons__comp_addr |
生产者环的节奏是:reserve(预留槽位)→ 填充 → submit(提交给内核)。
消费者环的节奏是:peek(窥视新数据)→ 读取 → release(归还给内核);若不想消费全部,还可调用 xsk_ring_cons__cancel 取消本次 peek。
新手常见问题 FAQ
-
Q:网卡驱动不支持 AF_XDP 怎么办? AF_XDP 需要驱动在普通 XDP 支持之上提供额外支持。可先查阅 XDP 程序类型文档 中的驱动支持表确认兼容性。
-
Q:bpffs 没挂载,多程序还能用吗? 可以。若内核不支持多程序特性所需能力,libxdp 会自动退化为"单程序直接加载"模式(可通过
xdp_multiprog__is_legacy判断)。 -
Q:metadata 修改为什么没生效?
xdp_program__set_run_prio等接口只能在 attach 之前调用,attach 之后再改不会起作用。
延伸阅读与仓库资源 📖
| 资料 | 路径 |
|---|---|
| libxdp 概念总览 | docs/ebpf-library/libxdp/libxdp.md |
| libxdp API 完整索引 | docs/ebpf-library/libxdp/SUMMARY.md |
| AF_XDP 概念详解 | docs/linux/concepts/af_xdp.md |
| XDP 程序类型与返回值 | docs/linux/program-type/BPF_PROG_TYPE_XDP.md |
| XSKMAP 映射表 | docs/linux/map-type/BPF_MAP_TYPE_XSKMAP.md |
| 库函数 YAML 数据源 | data/libxdp-functions.yaml |
掌握 XDP 程序加载、Dispatcher 多程序调度与 AF_XDP Socket 管理,你就具备了高性能网络数据面开发的核心拼图——配合 ebpf-docs 中的 libbpf 用户态 API 文档 继续深入吧!🚀