📚 课程目录第4章动态调试控制语法

4、动态调试控制语法：文件/函数/行号/模块的匹配模式、格式字符串过滤、控制命令详解

动态调试（Dynamic Debugging，dyndbg）是内核提供的一种在运行时控制 pr_debug() / dev_dbg() 等调试打印开关的机制。它允许开发者在不重新编译内核或模块的情况下，通过 debugfs 接口精确控制哪些代码路径输出日志。本节将深入解析其核心语法：匹配模式、格式过滤与控制命令。

前置条件：确保内核已开启 CONFIG_DYNAMIC_DEBUG 且 debugfs 已挂载（通常挂载在 /sys/kernel/debug/）。控制接口文件为 /sys/kernel/debug/dynamic_debug/control。

4.1 匹配模式：文件/函数/行号/模块

动态调试的匹配模式用于定位到具体的打印语句。每条 pr_debug() 在内核编译时都会被记录为一个“调试点”（debug point），包含其所在的文件名、函数名、行号以及所属模块名。控制命令通过组合这些属性来筛选目标。

匹配关键字	语法示例	匹配范围	说明
`file`	`file net/core/skbuff.c +p`	全文件	支持通配符 ``，如 `file net/core/ +p`
`func`	`func dev_queue_xmit +p`	函数内所有调试点	精确匹配函数名，不支持通配符
`line`	`file skbuff.c line 1200-1210 +p`	指定行号范围	可指定单行或区间，常与 `file` 联用
`module`	`module e1000 +p`	整个内核模块	适用于驱动或文件系统等可加载模块

  匹配优先级与组合：多个匹配条件可同时使用，它们之间是“与”关系。例如 file tcp_input.c func tcp_rcv_established line 500-600 +p 只会匹配同时满足这三个条件的调试点。

4.2 格式字符串过滤

除了基于代码位置的匹配，动态调试还支持对 pr_debug() 中的格式字符串进行关键词过滤。这对于在同一个函数中区分不同用途的打印非常有用。

语法：format "关键词" +p
匹配规则：格式字符串中只要包含指定的关键词即匹配，区分大小写。
典型场景：在 tcp_v4_do_rcv() 函数中，可能有多个 pr_debug() 分别打印“接收数据”、“校验和错误”、“窗口更新”等信息。通过 func tcp_v4_do_rcv format "checksum" +p 可以只开启与校验和相关的调试输出，大幅减少日志噪音。

性能注意：格式字符串过滤是在匹配引擎中进行的字符串比较，相比文件/函数匹配开销稍大。在性能敏感的生产环境中，建议优先使用 file 或 func 进行粗粒度过滤，再辅以 format 做细粒度筛选。

4.3 控制命令详解

控制命令由匹配模式和操作标志两部分组成，通过 echo 写入 control 文件来生效。核心操作标志如下：

标志	含义	示例	效果
`+p`	启用打印	`func skb_clone +p`	开启 `skb_clone` 函数内所有 `pr_debug`
`-p`	禁用打印	`func skb_clone -p`	关闭 `skb_clone` 函数内所有 `pr_debug`
`=p`	强制设置打印状态	`file net/ipv4/tcp_input.c =p`	将该文件所有调试点强制设为启用（覆盖默认状态）
`+f`	打印函数名	`func tcp_rcv_established +p +f`	输出日志时额外打印函数名前缀
`+l`	打印行号	`func tcp_rcv_established +p +l`	输出日志时额外打印行号前缀
`+m`	打印模块名	`module e1000 +p +m`	输出日志时额外打印模块名前缀
`+t`	打印时间戳	`file net/core/dev.c +p +t`	输出日志时额外打印时间戳（精度为 jiffies）

  组合命令示例：

  echo "func netif_receive_skb +p +f +l +t" > /sys/kernel/debug/dynamic_debug/control

  该命令会开启 netif_receive_skb 函数的所有调试打印，并在每条日志前附加函数名、行号和 jiffies 时间戳，非常适合追踪网络收包路径的时序。

4.4 常用操作模式与批量控制

在实际调试中，经常需要对大量调试点进行批量操作。以下列出几种高效模式：

清空所有动态调试：echo "" > /sys/kernel/debug/dynamic_debug/control 会禁用所有调试点。
查看当前状态：cat /sys/kernel/debug/dynamic_debug/control 列出所有调试点及其当前启用状态。
模块加载时自动启用：在 /etc/modprobe.d/ 下配置 options module_name dyndbg="+p"，可在模块加载时自动开启调试。
内核启动参数：在 GRUB 内核命令行中添加 dyndbg="file net/core/* +p"，可在系统启动早期即启用网络核心子系统的调试。

4.5 实战案例：精准定位网络丢包点

假设怀疑内核在 tcp_v4_rcv() 函数中发生了丢包，但该函数包含大量调试打印，全部开启会导致日志泛滥。可以采用分层过滤策略：

第一步：粗粒度定位模块
echo "module tcp +p" > /sys/kernel/debug/dynamic_debug/control
开启整个 TCP 协议栈的调试，观察丢包发生时的大致函数范围。
第二步：细粒度锁定函数
echo "func tcp_v4_rcv +p" > /sys/kernel/debug/dynamic_debug/control
关闭其他函数，只保留目标函数。
第三步：格式过滤缩小范围
echo "func tcp_v4_rcv format 'drop' +p" > /sys/kernel/debug/dynamic_debug/control
只打印包含“drop”关键词的日志，直接定位到丢包处理分支。
第四步：附加上下文信息
echo "func tcp_v4_rcv format 'drop' +p +f +l +t" > /sys/kernel/debug/dynamic_debug/control
在最终定位到的打印上附加函数名、行号和时序信息，便于分析丢包原因。

技巧：使用 grep 配合 cat 可以快速查看特定调试点的状态：
cat /sys/kernel/debug/dynamic_debug/control | grep tcp_v4_rcv
输出会显示该函数内所有调试点的文件名、行号、函数名、格式字符串以及当前是否启用（=p 表示启用，=_ 表示禁用）。