嵌入式 Linux 与 RTOS / 系统课时

用 dynamic debug 追踪驱动

用 dynamic debug 追踪驱动

驱动已经加载却只在特定 I/O 或错误路径上异常时,最有效的做法往往不是重编内核加日志,而是临时打开现有的 pr_debug、dev_dbg 调用点。本节用 dynamic debug 按模块、文件和函数控制日志,只在复现窗口内采集证据,再立即关闭高频输出。

学习目标

  • 确认内核是否提供 dynamic debug 控制接口,并识别可动态控制的调用点。
  • 按模块、文件或函数开启 pr_debug 日志,复现 probe、I/O 与错误分支。
  • 在获得证据后及时关闭调试,避免串口、环形缓冲区和实时路径被日志拖慢。

先确认控制接口可用

dynamic debug 的核心不是修改日志级别,而是给每个可控调用点维护一条运行时规则。常见控制文件是 /sys/kernel/debug/dynamic_debug/control;它依赖内核启用 dynamic debug,并且通常需要挂载 debugfs。控制文件存在并不代表某个驱动一定有可控日志,还要能在其中找到对应模块、源文件或函数。

先从驱动模块名入手最稳妥。模块名应使用内核实际登记的名称,而不是 .ko 文件名的猜测;可从 lsmod、modinfo 或控制文件内容核对。若目标驱动是内建驱动,则优先用源文件路径或函数名筛选。

按模块开启并复现一次路径

下面的命令模板会检查 debugfs 和控制文件,先列出目标模块的若干调用点,再临时打开该模块的打印开关,执行一次复现命令,读取最近内核日志,最后关闭开关。执行前把 <MODULE> 替换为实际模块名,把 <COMMAND> 替换为能触发 probe、读写或错误路径的命令。

bash
sudo bash -c '
set -e
CTRL=/sys/kernel/debug/dynamic_debug/control
MODULE="<MODULE>"
TRIGGER="<COMMAND>"

if [ ! -r "$CTRL" ]; then
  mkdir -p /sys/kernel/debug
  grep -q " /sys/kernel/debug debugfs " /proc/mounts || mount -t debugfs debugfs /sys/kernel/debug
fi
test -r "$CTRL"

grep -m 5 "\[$MODULE\]" "$CTRL" || grep -m 5 "$MODULE" "$CTRL" || true
printf "module %s +p\n" "$MODULE" > "$CTRL"

bash -lc "$TRIGGER"
dmesg | tail -n 30

printf "module %s -p\n" "$MODULE" > "$CTRL"
'

预期输出

text
<PATH>:<LINE> [<MODULE>]<FUNC> =_ "<DEBUG_FORMAT>"
...
[<TIME>] <MODULE>: <DEBUG_MESSAGE_FROM_TRIGGERED_PATH>

实际路径、行号、函数名、时间和日志文本会随内核版本与驱动实现变化。若控制文件能列出调用点,但复现后没有新日志,说明对应调用点没有被执行,或当前筛选范围没有覆盖真正经过的分支。

dynamic debug 从规则到驱动日志的控制链路

把粒度收紧到文件或函数

模块级 +p 适合第一次确认“日志链路通不通”,但不适合长时间保留。dynamic debug 的查询可以继续收窄:file drivers/foo/bar.c +p 只打开指定源文件,func my_probe +p 只打开函数,必要时还能结合行号范围定位一个局部分支。规则匹配的是内核编译后登记的调用点,所以源文件路径和函数名应以控制文件里的实际记录为准。

定位 probe 问题时,优先只开 probe 函数;定位数据通路时,优先锁定 read、write、IRQ 或 workqueue 处理函数。若错误分支只在某个文件中出现,则按文件打开后复现一次,再根据日志中的函数名继续缩小范围。这样比长期打开整个模块更容易把因果顺序读清楚。

控制日志成本并处理常见失败

dynamic debug 本身不需要重新编译内核,但前提是目标调用点确实被编译进动态调试目录。控制文件不存在时,先检查内核配置和 debugfs;写规则时报 Invalid argument 时,通常是选择器拼写或目标名称与目录记录不一致;规则写入成功却没有日志时,回到实际执行路径确认调用点是否命中。

高频中断、轮询和数据面函数最容易制造日志风暴。串口控制台尤其会把一次简单的 pr_debug 放大成明显时延,因此调试窗口应遵循“先缩小范围、再开启、立即复现、马上关闭”的顺序。完成定位后确认规则已经 -p,再进行性能测试,否则测到的可能只是日志开销而不是驱动本身的时延。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 dynamic debug 追踪驱动

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通