drgn项目v0.0.31版本发布：调试信息查找机制全面升级

项目简介

drgn是一个功能强大的调试器工具，专为Linux内核和用户空间程序调试而设计。它提供了Python接口，允许开发者以编程方式检查运行中的系统或核心转储文件的状态。与传统的调试器不同，drgn不需要在被调试系统中安装任何额外组件，这使得它特别适合生产环境的问题诊断。

版本亮点

本次发布的v0.0.31版本是自项目初始版本0.0.1以来最重要的更新之一，带来了多项重大改进和新功能，特别是在调试信息查找机制方面进行了全面重构。

核心改进

调试信息查找机制重构

本次版本对drgn查找调试符号的方式进行了彻底重写，引入了全新的模块概念和控制机制：

1. 新增模块类型类：

   • drgn.MainModule：主程序模块
   • drgn.SharedLibraryModule：共享库模块
   • drgn.VdsoModule：VDSO模块
   • drgn.RelocatableModule：可重定位模块
   • drgn.ExtraModule：额外模块

2. 增强的模块管理API：

   • 新增了modules()、loaded_modules()等方法用于查询和操作程序加载的模块
   • 提供了create_loaded_modules()等方法用于手动覆盖drgn的自动检测结果

3. 调试信息查找控制：

   • 新增drgn.Program.debug_info_options属性用于控制调试信息查找行为
   • 命令行工具增加了--try-symbols-by、--no-symbols-by等选项
   • 新增了register_debug_info_finder()等方法用于注册自定义调试信息查找器

4. 日志增强：

   • 现在会记录查找模块和调试符号的完整过程
   • 使用--log-level debug选项可以查看详细日志

调试符号匹配更严格

为了提高准确性，新版本对用户提供的调试符号文件实施了更严格的匹配规则（基于构建ID）。这一变化虽然提高了可靠性，但也带来了不兼容性：

• 不匹配任何加载模块的符号文件将被忽略并发出警告
• 如需强制使用特定文件，需要通过try_file(path, force=True)明确指定
• 完全独立于加载模块的调试符号可通过--extra-symbols选项加载

内核模块调试改进

不再强制要求depmod(8)元数据来查找Linux内核模块的调试符号（但仍会作为优化手段使用）。这一改进简化了内核模块调试的准备工作。

新功能与增强

1. debuginfod集成改进：

   • 添加了下载调试符号时的进度条显示
   • 支持从debuginfod下载内核调试信息（目前主要针对Fedora Linux内核）

2. 插件系统：

   • 新增插件架构，允许通过钩子扩展程序初始化过程
   • 插件可以注册调试信息查找器、对象/类型/符号查找器等

3. DWARF支持增强：

   • 新增对DWARF导入单元和gnu_debugaltlink文件的支持
   • 这些特性被某些Linux发行版使用

4. 命令行增强：

   • 新增-e选项支持直接从命令行运行代码片段
   • 改进对非终端标准输入的处理

5. 堆栈跟踪改进：

   • 即使没有完整的调试信息，drgn.StackFrame.name也能提供更有用的信息
   • 支持在没有调试符号文件的情况下使用ORC进行内核堆栈展开
   • 修复了AArch64平台上NULL函数指针调用的展开问题

6. 新辅助函数：

   • 新增drgn.helpers.linux.kthread模块，提供内核线程相关辅助函数
   • 新增kernfs_parent()和kernfs_root()辅助函数

兼容性更新

1. Linux内核支持：

   • 新增对Linux 6.14和6.15的支持
   • 更新了内核模块支持以兼容Linux 6.14
   • 更新了文件系统和kernfs辅助函数以兼容Linux 6.15

2. 平台特定修复：

   • 修复了CentOS/RHEL 9内核上的task_cpu()和堆栈跟踪问题
   • 改进了AArch64平台的支持

错误修复

1. 核心功能修复：

   • 修复了-s选项在用户空间程序中的地址查找问题
   • 修复了调试符号下载的中断处理（支持Ctrl-C）
   • 修复了kmodify.call_function()的类型检查和符号扩展问题

2. DWARF处理改进：

   • 修复了中间包含DW_OP_addr操作的DWARF表达式处理
   • 新增对DW_CFA_GNU_args_size操作的支持

3. 稳定性增强：

   • 修复了无效DWARF信息解析时的内存安全问题
   • 修复了del prog.language操作导致的段错误
   • 改进了对非标准核心转储文件的处理

文档与教程

1. 新增交互式教程：

   • 提供了详细的blk_rq_qos崩溃分析教程
   • 配套视频帮助用户快速上手

2. 文档改进：

   • 全面更新了获取调试符号的文档
   • 新增man page参考手册
   • 替换了文档中不兼容的which命令用法

总结

drgn v0.0.31版本通过重构调试信息查找机制、增强debuginfod集成、新增插件系统等重大改进，显著提升了调试体验和灵活性。特别是对内核模块调试和堆栈跟踪的改进，使得在生产环境中诊断复杂问题变得更加容易。虽然引入了一些不兼容的变化，但这些改变总体上提高了工具的可靠性和用户体验。