2. printk 调试技巧

在 Linux 内核驱动开发中，printk 是最基础、最直接的调试手段。它类似于用户空间的 printf，但运行在内核上下文，拥有独立的日志系统和级别控制机制。掌握 printk 的日志级别、控制台输出规则以及动态调整方法，是高效调试的第一步。

1. printk 日志级别与消息优先级

每个 printk 调用都带有一个日志级别（loglevel），用于标识消息的严重程度。内核根据这些级别决定是否将消息输出到控制台，以及是否写入系统日志缓冲区。

2. 控制台输出控制与日志缓冲区

内核日志系统由两个核心组件构成：日志缓冲区（ring buffer）和控制台输出过滤器。所有 printk 消息首先写入固定大小的环形缓冲区，然后根据控制台日志级别决定是否输出到物理控制台。

3. 动态调整日志级别

在调试过程中，无需重新编译内核或驱动，即可通过 /proc/sys/kernel/printk 文件实时调整日志级别。该文件包含 4 个整数值：

# cat /proc/sys/kernel/printk
7       4       1       7
# 字段含义：
# [0] console_loglevel  : 控制台日志级别（默认 7，即所有消息都显示）
# [1] default_message_loglevel : 未指定级别的 printk 默认级别（默认 4）
# [2] minimum_console_loglevel : 控制台可设置的最低级别（默认 1）
# [3] default_console_loglevel : 控制台默认级别（默认 7）

常用调整命令

• 关闭所有控制台输出（静默模式）：
  echo "0 4 1 7" > /proc/sys/kernel/printk
• 仅显示错误及以上级别：
  echo "3 4 1 7" > /proc/sys/kernel/printk
• 显示所有消息（调试模式）：
  echo "8 4 1 7" > /proc/sys/kernel/printk
• 临时提升当前控制台级别：
  echo 8 > /proc/sys/kernel/printk（仅修改第一个字段）

4. 使用 pr_debug / dev_dbg 进行条件调试

对于驱动开发，pr_debug() 和 dev_dbg() 是比 printk(KERN_DEBUG) 更灵活的选择。它们支持编译时和运行时的动态控制，避免在生产版本中输出过多调试信息。

编译时启用 pr_debug

在驱动源文件中，在包含任何头文件之前定义 DEBUG 宏：

#define DEBUG
#include <linux/module.h>
#include <linux/printk.h>

static int __init my_driver_init(void)
{
    pr_debug("Driver initializing...\n");
    // ...
    return 0;
}

运行时动态控制（Dynamic Debug）

Linux 内核的 Dynamic Debug 特性允许在运行时通过 debugfs 控制每个 pr_debug/dev_dbg 的开关，无需重新编译。

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

# 查看所有可控制的调试语句
cat /sys/kernel/debug/dynamic_debug/control

# 启用某个文件的全部调试输出
echo "file my_driver.c +p" > /sys/kernel/debug/dynamic_debug/control

# 启用某个函数的调试输出
echo "func my_function +p" > /sys/kernel/debug/dynamic_debug/control

# 禁用所有调试输出
echo "file my_driver.c -p" > /sys/kernel/debug/dynamic_debug/control

5. 实用技巧与避坑指南

• 使用 dmesg -w 实时查看：类似 tail -f，持续输出新日志，适合调试驱动加载过程。
• 时间戳：启用 dmesg -T 显示可读时间戳，或通过 echo "Y" > /sys/module/printk/parameters/time 让所有 printk 自带时间戳。
• 避免频繁 printk：在中断上下文或热路径中大量使用 printk 会导致系统延迟飙升，甚至触发看门狗复位。
• 使用 pr_info_ratelimited()：当需要限制输出频率时，使用限速版本宏，防止日志风暴。
• 区分 dev_err 与 pr_err：优先使用 dev_err(dev, ...) 系列，它自动包含设备名称，便于多设备场景下定位问题。