3. ftrace编译与配置

ftrace 是内核内置的跟踪器，其功能通过内核编译选项（Kconfig）控制。要在目标系统上使用 ftrace，必须在内核编译阶段正确启用相关配置。本章详细讲解关键配置项及其依赖关系，并给出典型配置组合。

3.1 核心配置项：CONFIG_FTRACE

CONFIG_FTRACE 是 ftrace 的总开关。只有启用此项，内核才会编译 ftrace 核心框架。该选项位于内核配置菜单的 Kernel hacking → Tracers 路径下。

3.2 配置依赖关系与层级结构

ftrace 的配置项存在严格的依赖链。下图展示了从总开关到具体跟踪器的层级关系。

3.3 关键配置项详解

3.3.1 CONFIG_FUNCTION_TRACER

启用后，内核会在每个函数的入口插入 mcount（或 fentry）调用。这是 function 和 function_graph 跟踪器的基础。开启此选项会增加内核映像大小约 10%~15%，并引入少量静态性能开销。

3.3.2 CONFIG_DYNAMIC_FTRACE

动态 ftrace 将 mcount 调用点初始化为 nop（空操作）指令。只有在用户通过 debugfs 启用跟踪时，内核才将 nop 替换为实际的跟踪指令。这使未启用跟踪时的性能开销几乎为零。

3.3.3 CONFIG_FTRACE_SYSCALLS

启用系统调用跟踪点。驱动调试中，当怀疑系统调用（如 open、ioctl、mmap）行为异常时，此选项可帮助跟踪用户态与内核态的交互边界。

3.4 典型配置组合（驱动调试场景）

以下配置组合适用于大多数驱动调试场景，兼顾功能完整性与性能。

3.5 配置操作步骤

1. 进入内核配置界面：

   make menuconfig

2. 导航到 Tracers 子菜单：

   Kernel hacking  --->
     [*] Tracers  --->

3. 启用核心选项：

   [*] Enable ftrace - Function Tracer
   [*]   Kernel Function Tracer
   [*]     Kernel Function Graph Tracer
   [*]   Enable/disable function tracing dynamically
   [*]   Trace syscalls
   [*]   Enable trace events

4. 保存并退出：选择 Save，然后退出配置界面。
5. 编译内核：

   make -j$(nproc)
   make modules_install
   make install

6. 验证配置是否生效：

   # 重启后检查 debugfs 挂载点
   mount -t debugfs none /sys/kernel/debug
   ls /sys/kernel/debug/tracing/

   如果看到 available_tracers、current_tracer、set_ftrace_filter 等文件，说明 ftrace 已正确启用。

3.6 配置验证：检查 /proc/config.gz

如果目标系统已经运行，可以通过以下命令检查当前内核的 ftrace 配置状态：

# 查看 CONFIG_FTRACE 是否启用
zcat /proc/config.gz | grep CONFIG_FTRACE

# 典型输出示例
CONFIG_FTRACE=y
CONFIG_FUNCTION_TRACER=y
CONFIG_FUNCTION_GRAPH_TRACER=y
CONFIG_DYNAMIC_FTRACE=y
CONFIG_FTRACE_SYSCALLS=y
CONFIG_FTRACE_EVENTS=y

如果 /proc/config.gz 不存在，可以尝试：

cat /boot/config-$(uname -r) | grep CONFIG_FTRACE

3.7 常见配置问题与排查