2. eBPF开发环境搭建：内核版本要求、内核配置选项与工具链安装

搭建一个正确的eBPF开发环境是进行文件系统IO路径监控实践的第一步。eBPF程序运行在内核空间，其功能特性与Linux内核版本、内核编译选项以及用户态工具链紧密相关。本章将详细阐述环境搭建的三大核心要素：内核版本选择、内核配置验证以及bpftool与clang/LLVM工具链的安装与验证。

2.1 Linux内核版本要求与特性矩阵

eBPF自Linux 3.18引入以来，每个内核版本都增加了关键特性。对于文件系统IO路径监控，我们需要关注与kprobe、tracepoint、perf事件以及BPF辅助函数相关的特性。下表列出了不同内核版本对eBPF核心特性的支持情况，帮助你根据监控需求选择合适的内核。

2.2 内核配置选项：开启eBPF功能

即使内核版本满足要求，如果编译时未开启相应的配置选项，eBPF功能也无法使用。以下是与eBPF文件系统IO监控相关的核心内核配置选项。你可以通过检查 /proc/config.gz 或 /boot/config-$(uname -r) 文件来验证当前内核的配置状态。

# 检查当前内核是否支持eBPF
zgrep CONFIG_BPF /proc/config.gz
zgrep CONFIG_BPF_SYSCALL /proc/config.gz
zgrep CONFIG_DEBUG_INFO_BTF /proc/config.gz

下表列出了必须开启和强烈建议开启的配置选项及其作用：

2.3 bpftool：eBPF程序管理的瑞士军刀

bpftool是内核源码树中提供的用户态工具，用于查看、加载和管理eBPF程序及maps。它是开发过程中不可或缺的调试和验证工具。

2.3.1 安装bpftool

bpftool的安装方式取决于你的发行版：

• Ubuntu/Debian： sudo apt-get install linux-tools-common linux-tools-$(uname -r)
• CentOS/RHEL： sudo yum install bpftool 或 sudo dnf install bpftool
• 从源码编译： 克隆内核源码树，进入 tools/bpf/bpftool 目录，执行 make && sudo make install

2.3.2 验证bpftool安装

安装完成后，通过以下命令验证其功能：

# 查看bpftool版本
bpftool --version

# 列出当前系统已加载的所有eBPF程序
bpftool prog list

# 查看当前系统已创建的所有eBPF maps
bpftool map list

# 查看特定eBPF程序的详细信息（假设程序ID为12）
bpftool prog show id 12

2.4 clang/LLVM工具链：编译eBPF程序

eBPF程序通常使用C语言编写，然后通过clang/LLVM编译器编译成BPF字节码。LLVM对BPF后端的支持是eBPF开发的核心。

2.4.1 安装clang/LLVM

推荐使用LLVM 11或更高版本，以获得对BPF CO-RE特性的完整支持。

• Ubuntu/Debian： sudo apt-get install clang llvm
• CentOS/RHEL： sudo yum install clang llvm 或 sudo dnf install clang llvm
• 从源码编译： 从 LLVM官网 下载源码，配置时开启BPF后端：cmake -DLLVM_TARGETS_TO_BUILD="BPF" ...

2.4.2 验证工具链

编写一个简单的eBPF程序骨架，验证编译环境是否正常。

// test_bpf.c
#include <linux/bpf.h>
#include <bpf/bpf_helpers.h>

SEC("kprobe/sys_openat")
int trace_openat(struct pt_regs *ctx)
{
    bpf_printk("openat syscall triggered\n");
    return 0;
}

char _license[] SEC("license") = "GPL";

使用以下命令编译：

# 编译为BPF字节码目标文件
clang -O2 -target bpf -c test_bpf.c -o test_bpf.o

# 查看编译后的BPF程序信息
bpftool prog load test_bpf.o /sys/fs/bpf/test_prog

# 如果编译成功且加载成功，说明环境搭建完成
bpftool prog list | grep test_prog

2.5 环境搭建整体流程SVG图

下图展示了从内核配置验证到工具链安装的完整环境搭建流程，以及各组件之间的依赖关系。

2.6 常见问题与避坑指南

2.7 环境验证清单

完成上述步骤后，使用以下清单快速验证你的开发环境是否就绪：