📚 课程目录第2章 printk入门

Linux内核驱动调试：printk与动态调试实战技巧 - 第2节

2.1 printk 函数原型与调用约定

printk 是 Linux 内核中最基础、最常用的日志输出函数，其原型定义在 <linux/printk.h> 中。与用户空间的 printf 类似，printk 采用格式化字符串加可变参数的方式，但增加了日志级别（log level）字段，用于控制消息的严重程度和输出行为。

// printk 函数原型
int printk(const char *fmt, ...);

调用约定：

格式化语法：支持 %d、%x、%p、%s、%lx 等标准格式说明符，与用户态 printf 一致。
返回值：成功时返回写入的字符数（不含结尾 '\0'），失败时返回负的错误码。
日志级别嵌入：日志级别以 <n> 形式写在格式字符串开头，例如 printk(KERN_INFO "Hello\n");。若不指定级别，内核会使用默认级别 DEFAULT_MESSAGE_LOGLEVEL（通常为 KERN_WARNING）。
原子上下文安全：printk 可在中断上下文、自旋锁保护区、调度器关闭等原子上下文中调用，不会引起睡眠。

💡 开发提示： 在驱动开发初期，建议所有调试信息都显式指定日志级别，避免因默认级别不一致导致关键信息被过滤或淹没。

2.2 日志级别详解：从 KERN_EMERG 到 KERN_DEBUG

Linux 内核定义了 8 个日志级别，数字越小表示消息越紧急。级别定义在 <linux/kern_levels.h> 中，每个级别对应一个宏，展开后为 "<n>" 形式的字符串前缀。

宏名称	级别值	含义	典型使用场景
`KERN_EMERG`	0	紧急事件，系统不可用	致命硬件故障、内核 panic 前兆
`KERN_ALERT`	1	必须立即处理	严重内存损坏、文件系统崩溃
`KERN_CRIT`	2	临界条件	驱动初始化失败、DMA 超时
`KERN_ERR`	3	错误条件	设备 I/O 错误、资源分配失败
`KERN_WARNING`	4	警告，可能存在问题	降级模式、配置不匹配
`KERN_NOTICE`	5	正常但重要的事件	设备热插拔、模块加载/卸载
`KERN_INFO`	6	信息性消息	驱动版本、硬件探测结果
`KERN_DEBUG`	7	调试信息	函数入口/出口、变量值跟踪

⚠️ 重要规则： 生产环境中，KERN_DEBUG 级别的消息默认被 console_loglevel 过滤，不会输出到控制台，但会写入内核日志缓冲区（dmesg）。调试驱动时，可通过 echo 8 > /proc/sys/kernel/printk 临时提升控制台级别以显示所有调试信息。

2.3 日志级别过滤机制与 printk 控制

内核通过三个关键变量控制 printk 消息的最终去向：

console_loglevel：当前控制台允许显示的最高日志级别（数值越大，显示越详细）。只有级别值 ≤ 该值的消息才会输出到控制台。
default_message_loglevel：未指定级别的 printk 消息默认使用的级别。
minimum_console_loglevel：控制台可设置的最低级别，防止完全关闭控制台输出。

查看当前设置：

cat /proc/sys/kernel/printk
# 输出示例：7       4       1       7
# 分别对应：console_loglevel, default_message_loglevel, minimum_console_loglevel, default_console_loglevel

动态调整控制台级别：

# 显示所有消息（包括 KERN_DEBUG）
echo 8 > /proc/sys/kernel/printk

# 只显示 KERN_ERR 及以上（0-3）
echo 3 > /proc/sys/kernel/printk

  🔧 调试技巧： 在驱动开发阶段，建议在 insmod 前执行 echo 8 > /proc/sys/kernel/printk，确保所有调试信息都能实时显示在终端上。调试完成后恢复默认值 echo 4 > /proc/sys/kernel/printk。

2.4 日志级别选择策略与实战建议

合理选择日志级别是驱动调试的基本功。以下是一套经过验证的选择策略：

消息类型	推荐级别	理由
致命硬件错误（如 PCIe 链路断开）	`KERN_CRIT`	需要立即引起注意，通常伴随恢复尝试
驱动 probe 失败	`KERN_ERR`	用户需要知道设备为何无法使用
降级模式或回退路径	`KERN_WARNING`	系统仍可运行，但性能或功能受限
设备插入/移除	`KERN_NOTICE`	正常但值得记录的系统事件
驱动版本、硬件配置摘要	`KERN_INFO`	帮助用户确认驱动已正确加载
函数调用跟踪、变量值	`KERN_DEBUG`	仅在调试阶段需要，生产环境应关闭

💡 经验法则： 当不确定使用哪个级别时，从 KERN_INFO 开始，调试阶段再降级为 KERN_DEBUG。永远不要在生产代码中使用 KERN_EMERG 或 KERN_ALERT 报告普通错误，这会导致系统管理员误判为灾难性故障。

2.5 日志级别与消息路由：SVG 流程图

下图展示了 printk 消息从调用到输出的完整路径，以及日志级别在各个环节的过滤作用：

2.6 实战示例：驱动中的 printk 使用

以下是一个虚拟字符设备驱动的 probe 函数片段，展示了不同日志级别的典型用法：

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

static int my_driver_probe(struct platform_device *pdev)
{
    int ret;
    struct resource *res;

    pr_info("my_driver: probing device %s\n", pdev->name);

    res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
    if (!res) {
        pr_err("my_driver: failed to get memory resource\n");
        return -ENXIO;
    }

    ret = request_mem_region(res->start, resource_size(res), "my_driver");
    if (!ret) {
        pr_crit("my_driver: memory region conflict at 0x%llx\n",
                (unsigned long long)res->start);
        return -EBUSY;
    }

    pr_notice("my_driver: registered memory region [0x%llx-0x%llx]\n",
              (unsigned long long)res->start,
              (unsigned long long)res->end);

    /* 调试信息：仅在 DEBUG 模式下输出 */
    pr_debug("my_driver: probe completed successfully\n");

    return 0;
}

  📝 代码要点：
  pr_info、pr_err、pr_crit、pr_notice、pr_debug 是 printk 的快捷宏，自动添加对应日志级别前缀。
pr_debug 在未定义 DEBUG 宏时会被编译为空，不会产生任何运行时开销。
资源申请失败使用 pr_crit（临界），因为内存区域冲突通常意味着系统级配置错误。

2.7 日志级别与性能影响

虽然 printk 设计为轻量级，但在高频调用路径（如中断处理、热路径）中仍需谨慎使用：

场景	建议	原因
中断处理函数（ISR）	仅使用 `KERN_DEBUG`，且加条件编译	避免在原子上下文中引入过多延迟
数据包处理热路径	使用 `trace_printk` 或动态调试替代	`printk` 的格式化开销在高吞吐下不可忽略
驱动初始化/卸载	自由使用 `KERN_INFO` ~ `KERN_ERR`	这些路径执行频率低，性能影响可忽略
错误恢复路径	使用 `KERN_WARNING` 或 `KERN_ERR`	错误路径本身已消耗资源，增加日志开销可接受

⚠️ 性能陷阱： 在循环或频繁调用的函数中，即使使用 KERN_DEBUG，如果控制台级别允许显示，printk 的串行化输出（通过 console_sem 互斥锁）仍可能成为性能瓶颈。此时应使用 pr_debug_ratelimited 或动态调试的 _ratelimited 变体。

2.8 本章小结

printk 原型：int printk(const char *fmt, ...)，支持标准格式化，可在原子上下文调用。
8 个日志级别：从 KERN_EMERG (0) 到 KERN_DEBUG (7)，数字越小越紧急。
过滤机制：console_loglevel 控制控制台输出阈值，/proc/sys/kernel/printk 可动态调整。
选择策略：致命错误用 KERN_CRIT，驱动错误用 KERN_ERR，正常信息用 KERN_INFO，调试用 KERN_DEBUG。
性能意识：热路径避免高频 printk，使用限速变体或动态调试替代。