1. printk 概述：内核调试的“第一束光”
在 Linux 内核开发与调试中，printk 是最基础、最直接、也是最可靠的调试手段。它相当于内核世界的 printf，能够在几乎任何上下文（中断、原子操作、调度器）中输出日志信息，是内核工程师排查问题的“第一把扳手”。
核心认知：printk 是内核调试的“最后防线”——当 kgdb、ftrace、perf 等高级工具因系统崩溃或环境限制无法使用时，printk 依然能通过串口或 dmesg 输出关键信息。
1.1 printk 在内核调试中的角色
printk 承担着以下关键角色：
- 启动阶段诊断：在系统初始化早期（如中断控制器、内存管理、调度器初始化），其他调试手段尚未就绪，printk 是唯一的信息输出通道。
- 异常与崩溃记录：当内核触发 oops、panic 或死锁时，printk 输出的调用栈和寄存器信息是定位问题的核心依据。
- 驱动开发验证：在编写或移植设备驱动时，通过 printk 输出寄存器值、中断状态、DMA 传输进度等实时数据。
- 性能瓶颈分析：在关键路径上插入时间戳 printk，可以粗略测量函数执行耗时（配合
jiffies或ktime_get()）。 - 协议栈跟踪：在网络、文件系统、USB 等复杂协议栈中，逐层打印数据包或请求的处理流程。
实战经验：在嵌入式开发中，printk 常通过 UART 串口输出，配合
console=ttyS0,115200 内核启动参数，可以在无显示器的设备上实时查看内核日志。
1.2 printk 与用户态 printf 的区别
虽然 printk 的格式化语法与 printf 高度相似，但两者在运行环境、同步机制、输出目标等方面存在本质差异。下表总结了关键区别：
| 对比维度 | printk（内核态） | printf（用户态） |
|---|---|---|
| 运行上下文 | 进程上下文、中断上下文、原子上下文、NMI | 仅进程上下文 |
| 输出目标 | 内核日志缓冲区（ring buffer），可重定向到串口、VGA、netconsole | 标准输出（stdout），通常为终端或文件 |
| 同步机制 | 自旋锁保护日志缓冲区，可能关中断 | 标准 I/O 锁（可能阻塞） |
| 日志分级 | 8 级日志级别（KERN_EMERG ~ KERN_DEBUG） | 无内置分级，需自行实现 |
| 格式化限制 | 不支持浮点数（%f），不支持宽字符（%ls） | 完整支持 C 标准格式化 |
| 缓冲区大小 | 固定大小（默认 4KB ~ 2MB，可配置） | 由 libc 管理，通常可动态扩展 |
| 调用开销 | 较高（格式化 + 自旋锁 + 可能唤醒 klogd） | 取决于缓冲策略，通常较低 |
注意：在中断处理程序或自旋锁持有期间调用 printk 时，如果日志级别低于
console_loglevel，printk 会尝试获取控制台锁，可能导致递归死锁。此时应使用 printk_deferred() 或 pr_emerg 等不会立即刷入控制台的变体。
1.3 基本使用场景
printk 在以下典型场景中发挥着不可替代的作用：
- 内核启动调试：在
start_kernel()早期阶段插入 printk，确认初始化流程是否按预期执行。 - 驱动 probe 验证：在驱动入口函数
probe()中打印设备 ID、资源映射地址、中断号等信息。 - 中断处理跟踪：在 ISR（中断服务程序）中打印中断状态寄存器，确认中断触发频率和来源。
- 内存分配监控：在
kmalloc/kzalloc前后打印分配大小和返回地址，排查内存泄漏。 - 锁竞争分析：在
spin_lock/mutex_lock前后打印时间戳，检测锁持有时间异常。 - 系统调用拦截：在关键系统调用入口（如
sys_open）添加 printk，记录文件访问行为。
代码示例：在驱动 probe 函数中使用 printk 输出调试信息
static int my_driver_probe(struct platform_device *pdev)
{
struct resource *res;
void __iomem *base;
res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
base = devm_ioremap_resource(&pdev->dev, res);
if (IS_ERR(base))
return PTR_ERR(base);
/* 输出关键调试信息 */
printk(KERN_INFO "my_driver: probe device %s\n", pdev->name);
printk(KERN_DEBUG "my_driver: phys addr = 0x%llx, size = %lld\n",
(unsigned long long)res->start,
(unsigned long long)resource_size(res));
printk(KERN_DEBUG "my_driver: ioremap addr = 0x%p\n", base);
return 0;
}1.4 printk 日志输出流程
下图展示了 printk 从调用到最终输出的完整路径：
1.5 日志级别与输出控制
printk 支持 8 个日志级别，定义在 <linux/kern_levels.h> 中。级别越低，优先级越高：
| 宏定义 | 级别值 | 含义 | 典型使用场景 |
|---|---|---|---|
KERN_EMERG |
0 | 紧急事件，系统不可用 | 内核 panic 前输出 |
KERN_ALERT |
1 | 必须立即处理 | 严重硬件故障 |
KERN_CRIT |
2 | 临界条件 | 驱动 probe 失败 |
KERN_ERR |
3 | 错误条件 | I/O 操作失败 |
KERN_WARNING |
4 | 警告 | 资源不足 |
KERN_NOTICE |
5 | 正常但重要 | 模块加载/卸载 |
KERN_INFO |
6 | 信息性消息 | 驱动版本信息 |
KERN_DEBUG |
7 | 调试信息 | 开发阶段详细日志 |
最佳实践：在产品内核中，建议将
console_loglevel 设置为 4（KERN_WARNING），仅输出错误及以上级别的日志，避免调试信息影响性能。开发阶段可临时设置为 7 以获取完整日志。
1.6 常用 printk 封装宏
为简化调用，内核提供了与日志级别对应的封装宏，推荐优先使用：
/* 等价于 printk(KERN_EMERG ...) */
pr_emerg("System halted!\n");
/* 等价于 printk(KERN_ALERT ...) */
pr_alert("Critical temperature reached!\n");
/* 等价于 printk(KERN_CRIT ...) */
pr_crit("Device probe failed\n");
/* 等价于 printk(KERN_ERR ...) */
pr_err("DMA transfer error: %d\n", ret);
/* 等价于 printk(KERN_WARNING ...) */
pr_warn("Low memory, %lu pages free\n", nr_free_pages());
/* 等价于 printk(KERN_NOTICE ...) */
pr_notice("Module loaded, version %s\n", VERSION);
/* 等价于 printk(KERN_INFO ...) */
pr_info("Registered IRQ %d\n", irq);
/* 等价于 printk(KERN_DEBUG ...) */
pr_debug("Function %s entered\n", __func__);
注意：
pr_debug() 在未定义 DEBUG 宏时会被编译为空，不会产生任何运行时开销。这是生产内核中保留调试代码的标准做法。
1.7 本章小结
printk 作为内核调试的基石，其核心价值在于：
- 无处不在：可在任何内核上下文中调用，是系统崩溃时的最后信息通道。
- 分级控制：通过 8 级日志级别和
console_loglevel机制，灵活控制输出粒度。 - 低依赖：不需要用户态文件系统、网络栈或特定硬件支持，仅依赖内核日志缓冲区。
- 易于集成：语法与 printf 一致，学习成本低，可快速嵌入到任意内核代码中。