3. 动态调试（dyndbg）：动态调试原理、启用与配置、动态控制调试信息的打印

动态调试（Dynamic Debug，简称 dyndbg）是 Linux 内核提供的一种高级调试信息控制机制。它允许开发者在系统运行时，动态地启用或禁用内核代码中预定义的调试打印语句（pr_debug()、dev_dbg() 等），而无需重新编译内核或重启系统。这极大地提升了驱动调试的灵活性和效率，尤其适用于现场问题排查和性能敏感场景。

3.1 动态调试原理

动态调试的核心思想是在编译阶段，将调试打印语句的元数据（如文件名、函数名、行号、格式字符串）嵌入到内核映像的一个特殊段（.dyndbg 段）中。运行时，通过 debugfs 文件系统接口或内核参数，根据这些元数据匹配规则，动态控制每条调试语句的“开关”状态。

3.2 启用与配置

要使用动态调试功能，需要在内核配置中启用相关选项，并确保 debugfs 已挂载。

3.2.1 内核配置选项

3.2.2 挂载 debugfs

在目标系统上，通常需要手动挂载 debugfs：

# 挂载 debugfs 到 /sys/kernel/debug
mount -t debugfs none /sys/kernel/debug

# 验证挂载
ls /sys/kernel/debug/dynamic_debug/control

3.3 动态控制调试信息的打印

动态调试的核心操作接口是 /sys/kernel/debug/dynamic_debug/control 文件。通过向该文件写入控制命令，可以实现对调试信息的精确控制。

3.3.1 控制命令格式

控制命令遵循统一的语法格式：

match_spec [flags] [module module_name]
# match_spec 可以是以下组合：
#   file FILENAME_PATTERN
#   func FUNCTION_NAME
#   line LINE_NUMBER
#   format FORMAT_STRING

标志位（flags）说明：

• +p：启用（打印）该调试语句。
• -p：禁用（静默）该调试语句。
• +f：在输出中包含函数名。
• +l：在输出中包含行号。
• +m：在输出中包含模块名。
• +t：在输出中包含线程 ID。

3.3.2 常用控制示例

3.3.3 查询当前调试状态

读取 control 文件可以查看所有可调试语句及其当前状态：

# 查看所有动态调试点
cat /sys/kernel/debug/dynamic_debug/control

# 输出示例（每行代表一个调试点）：
# drivers/usb/core/hub.c:1234 [usbcore]hub_event =_ "hub status change\012"
# drivers/usb/core/hub.c:1256 [usbcore]hub_event =p "port %d status %x\012"

输出格式说明：文件名:行号 [模块名]函数名 =标志位 "格式字符串"。其中 =_ 表示禁用，=p 表示启用。

3.4 在驱动代码中使用动态调试

驱动开发者只需使用标准的调试打印宏，动态调试框架会自动接管控制：

#include <linux/device.h>
#include <linux/printk.h>

static int my_driver_probe(struct platform_device *pdev)
{
    struct device *dev = &pdev->dev;

    // 使用 dev_dbg()，动态调试可控制其输出
    dev_dbg(dev, "Probe called for device %s\n", dev_name(dev));

    // 使用 pr_debug()，同样受动态调试控制
    pr_debug("my_driver: resource count = %d\n", pdev->num_resources);

    return 0;
}

3.5 内核启动参数配置

除了运行时通过 debugfs 控制，动态调试还支持在系统启动阶段通过内核命令行参数进行初始化配置：

# 在 bootargs 中添加
dyndbg="file drivers/usb/core/* +p ; func probe +p"

# 或者通过 module 参数
usbcore.dyndbg="+p"

启动参数使用分号分隔多条规则，支持与运行时相同的匹配语法。这对于早期启动阶段的调试（如 USB 子系统初始化）非常有用。

3.6 动态调试 vs 传统调试方法