4. kmemleak 内核命令行参数：使用方法与实战解析

kmemleak 的运行时行为完全由内核命令行参数控制。正确配置这些参数，是驱动开发中进行高效内存泄漏检测的第一步。本章将详细解析 kmemleak=on/off、kmemleak=scan、kmemleak=clear 等核心参数的使用方法、适用场景及注意事项。

4.1 参数总览与功能对比

kmemleak 支持的内核命令行参数主要分为三类：开关控制、扫描控制、状态管理。下表列出了最常用的参数及其功能描述：

参数	功能分类	默认值	说明
kmemleak=on	开关控制	off	启用 kmemleak 内核内存泄漏检测器
kmemleak=off	开关控制	—	禁用 kmemleak（默认状态）
kmemleak=scan	扫描控制	on	启用自动内存扫描（默认开启）
kmemleak=no_scan	扫描控制	—	禁用自动扫描，仅手动触发
kmemleak=clear	状态管理	—	启动时清除所有已记录的泄漏报告
kmemleak=panic	错误处理	off	检测到泄漏时触发内核 panic

4.2 核心参数详解

4.2.1 kmemleak=on / off：启用与禁用

这是最基础的参数对。在 GRUB 或 U-Boot 的内核命令行中添加 kmemleak=on 即可激活检测器。禁用时，kmemleak 不会分配任何内部数据结构，对系统性能零影响。

典型配置示例（GRUB）：

# /etc/default/grub
GRUB_CMDLINE_LINUX="kmemleak=on console=tty0 ..."
# 更新 GRUB 配置
sudo update-grub
# 重启系统
sudo reboot

验证是否启用：

# 检查内核启动日志
dmesg | grep -i kmemleak
# 输出示例：
# [    0.000000] Kernel command line: ... kmemleak=on ...
# [    0.123456] kmemleak: Kernel memory leak detector initialized

# 查看 debugfs 接口是否存在
ls /sys/kernel/debug/kmemleak

4.2.2 kmemleak=scan / no_scan：自动扫描控制

kmemleak 默认每隔 10 分钟自动执行一次内存扫描。通过 kmemleak=no_scan 可以关闭自动扫描，改为完全由用户手动触发。这在以下场景中非常有用：

• 驱动加载/卸载测试： 在加载驱动前手动触发一次扫描作为基线，卸载后再触发一次扫描对比差异。
• 性能敏感环境： 避免周期性扫描干扰实时任务。
• 精确泄漏定位： 在特定操作前后手动扫描，缩小泄漏范围。

手动触发扫描命令：

# 触发一次完整扫描
echo scan > /sys/kernel/debug/kmemleak

# 查看扫描结果
cat /sys/kernel/debug/kmemleak

4.2.3 kmemleak=clear：启动时清除历史记录

在开发过程中，系统可能已经运行了很长时间，积累了大量的历史泄漏报告。使用 kmemleak=clear 参数可以在内核初始化阶段清空所有已记录的泄漏信息，让检测器从“干净”状态开始工作。

使用场景：

• 在集成测试前重置状态。
• 切换驱动版本后清除旧报告。
• 配合 kmemleak=on 一起使用，确保启动后立即开始全新检测。

运行时手动清除：

# 清除所有当前泄漏报告（不停止检测）
echo clear > /sys/kernel/debug/kmemleak

4.3 参数组合与工作流程

下图展示了不同参数组合下 kmemleak 的启动流程与工作模式：

4.4 运行时动态控制接口

除了内核命令行参数，kmemleak 还提供了 /sys/kernel/debug/kmemleak 伪文件接口，允许在系统运行期间动态控制检测行为。下表总结了命令行参数与运行时接口的对应关系：

功能	命令行参数	运行时接口（echo 到 debugfs）
启用检测	kmemleak=on	不支持（需重启）
禁用检测	kmemleak=off	echo off > /sys/kernel/debug/kmemleak
触发扫描	—	echo scan > /sys/kernel/debug/kmemleak
清除报告	kmemleak=clear	echo clear > /sys/kernel/debug/kmemleak
设置扫描间隔	—	echo scan=600 > /sys/kernel/debug/kmemleak（单位秒）
触发 panic	kmemleak=panic	echo panic=on > /sys/kernel/debug/kmemleak

4.5 常见配置场景与示例

根据不同的开发阶段，推荐以下参数配置策略：

• 日常开发调试： kmemleak=on — 启用检测，使用默认自动扫描，适合快速发现明显泄漏。
• 精确泄漏定位： kmemleak=on kmemleak=no_scan — 关闭自动扫描，完全手动控制扫描时机，避免扫描结果被定时任务污染。
• 回归测试/CI 环境： kmemleak=on kmemleak=clear kmemleak=panic — 启动时清空历史，检测到泄漏立即 panic，便于自动化测试捕获。
• 性能评估： kmemleak=off — 完全禁用，零开销。

完整启动参数示例：

# 适用于驱动模块开发者的推荐配置
GRUB_CMDLINE_LINUX="kmemleak=on kmemleak=no_scan kmemleak=clear loglevel=8"

# 参数含义：
# kmemleak=on      : 启用内存泄漏检测
# kmemleak=no_scan : 关闭自动扫描，手动控制
# kmemleak=clear   : 启动时清空历史报告
# loglevel=8       : 开启详细内核日志，便于跟踪

4.6 参数使用注意事项