📚 课程目录第2章 dmesg日志基础

2. dmesg日志基础：命令使用、日志级别与缓冲区管理

dmesg（diagnostic message）是Linux内核向用户空间输出诊断信息的核心工具，也是显示驱动故障排查的第一道防线。当显示驱动在初始化、模式设置（Mode-Setting）、帧缓冲操作或热插拔过程中发生异常时，dmesg日志会记录下关键的错误码、寄存器状态和调用栈。掌握dmesg命令的使用方法、理解日志级别的语义、并能管理日志缓冲区，是每一位显示调试工程师的基本功。

2.1 dmesg命令的使用方法

dmesg命令从内核环形缓冲区（ring buffer）中读取由printk输出的日志。以下是最常用的操作模式：

命令	功能说明	显示调试典型场景
`dmesg`	打印内核环形缓冲区全部内容	查看驱动加载全貌
`dmesg -T`	以人类可读时间戳显示日志	关联显示异常与系统启动时间
`dmesg -l err`	仅显示错误级别日志	快速定位显示驱动报错
`dmesg -l warn`	仅显示警告级别日志	检查显示模式降级或回退
`dmesg -f kern`	仅显示内核子系统日志	过滤非驱动干扰信息
`dmesg -w`	实时等待新日志输出	监控热插拔或模式切换
`dmesg -c`	读取并清空缓冲区	隔离新测试产生的日志
`dmesg -n 3`	设置控制台日志级别	减少控制台打印干扰

调试技巧：在显示驱动调试中，建议先执行 dmesg -c 清空缓冲区，再加载驱动或触发显示事件，最后使用 dmesg -T -l err,warn 获取带时间戳的错误和警告日志，避免被启动阶段的大量信息淹没。

2.2 日志级别：KERN_EMERG 到 KERN_DEBUG

内核通过printk函数输出日志时，必须指定一个日志级别（loglevel）。级别决定了消息的严重程度以及是否显示在控制台上。显示驱动中常见的日志级别使用场景如下：

宏定义	数值	含义	显示驱动典型用法
`KERN_EMERG`	0	紧急事件，系统不可用	GPU硬件致命错误，总线异常
`KERN_ALERT`	1	必须立即处理	显示控制器挂起，无法恢复
`KERN_CRIT`	2	严重条件	VRAM访问超时，关键寄存器校验失败
`KERN_ERR`	3	错误条件	EDID读取失败、模式设置拒绝、I2C通信错误
`KERN_WARNING`	4	警告条件	显示分辨率回退、刷新率降级、训练失败
`KERN_NOTICE`	5	正常但重要	显示设备连接/断开、驱动绑定成功
`KERN_INFO`	6	信息性消息	显示模式参数、帧缓冲地址、面板时序
`KERN_DEBUG`	7	调试级别消息	寄存器读写跟踪、状态机跳转、中断计数

注意：控制台日志级别（console_loglevel）默认只显示数值小于等于该级别的消息。如果控制台级别设置为4（KERN_WARNING），则KERN_INFO和KERN_DEBUG消息不会打印到控制台，但仍会写入环形缓冲区，可通过dmesg命令读取。在显示驱动开发阶段，建议将控制台级别临时设为7以捕获所有调试信息。

以下是一个显示驱动中printk使用的代码示例：

/* 显示驱动中的典型日志输出 */
printk(KERN_ERR "drm: failed to read EDID from connector %d\n", connector_id);
printk(KERN_WARNING "drm: mode %dx%d@%dHz not supported, falling back\n",
       width, height, refresh);
printk(KERN_INFO "drm: framebuffer at physical address 0x%lx\n", fb_addr);
printk(KERN_DEBUG "drm: write register 0x%04x = 0x%08x\n", reg, val);

2.3 日志缓冲区管理

内核日志缓冲区是一个固定大小的环形缓冲区（ring buffer），默认大小通常为128KB或可配置。理解其管理机制对于长时间运行的显示调试至关重要，因为旧日志可能被新日志覆盖。

2.3.1 缓冲区结构

2.3.2 缓冲区大小调整

在显示驱动调试中，如果遇到大量调试输出（如每帧寄存器状态），默认缓冲区可能很快被填满。可以通过内核启动参数调整缓冲区大小：

# 在GRUB内核命令行中添加
log_buf_len=4M

# 或通过sysfs动态调整（需要内核支持）
echo 4194304 > /sys/kernel/debug/printk/ring_buffer_size

2.3.3 持久化与日志保存

由于环形缓冲区在系统重启后会丢失，对于显示驱动的间歇性故障，建议使用以下方法持久化日志：

rsyslog/journald：配置将内核日志写入磁盘文件，如/var/log/kern.log
pstore/ramoops：在系统崩溃时保留最后一段dmesg日志到内存保留区
串口捕获：通过console=ttyS0,115200将日志输出到串口，由外部主机记录
netconsole：通过网络将内核日志发送到远程日志服务器

  显示调试最佳实践：在调试显示驱动初始化失败或GPU挂起问题时，建议同时开启串口日志和pstore。串口日志可以捕获实时输出，pstore则能在系统完全死机前保存最后的日志快照，两者互补可以覆盖绝大多数故障场景。

2.3.4 查看缓冲区状态

通过/proc/sys/kernel/printk文件可以查看当前日志系统的配置：

$ cat /proc/sys/kernel/printk
7       4       1       7
# 分别表示：控制台日志级别、默认消息日志级别、最小控制台日志级别、默认控制台日志级别

在显示驱动调试中，建议将控制台日志级别临时设置为7：

# 临时设置，重启后失效
echo 7 > /proc/sys/kernel/printk

# 或使用dmesg命令
dmesg -n 7

2.4 显示驱动日志过滤实战

当系统中存在多个显示设备或驱动时，dmesg输出可能非常庞大。以下是一些高效的过滤技巧：

过滤目标	命令示例	说明
DRM子系统日志	`dmesg \| grep -i drm`	过滤所有DRM相关消息
特定驱动日志	`dmesg \| grep -i i915`	Intel显示驱动日志
EDID相关	`dmesg \| grep -i edid`	显示器EDID读取过程
模式设置	`dmesg \| grep -E "mode\|resolution\|timing"`	显示模式协商过程
热插拔事件	`dmesg -w \| grep -i "hotplug\|connected\|disconnected"`	实时监控显示设备插拔
错误和警告	`dmesg -l err,warn \| grep -i display`	仅显示显示相关的错误和警告

效率提升：建议将常用过滤命令定义为shell别名，例如：alias dmesg-drm='dmesg -T -l err,warn,info | grep -E "drm|i915|amdgpu|nouveau"'，一键获取所有显示驱动相关日志。