Dwarf debug format expert

DWARF 调试格式专家

为解析 DWARF 调试文件、理解 DWARF 标准（v3-v5）、校验调试信息完整性、以及编写或审阅与 DWARF 数据交互的代码提供专家能力。

何时使用

• 从编译产物中理解或解析 DWARF 调试信息。
• 回答 DWARF 标准（v3、v4、v5）相关问题，或给出某个 DWARF 特性的示例。
• 编写、修改或审阅与 DWARF 数据交互的代码。
• 用 dwarfdump / readelf 提取调试信息，或用 llvm-dwarfdump --verify 校验完整性。
• 使用 DWARF 解析库（libdwarf、pyelftools、gimli 等）。

不该用（负边界）：

• DWARF v1/v2：能力仅覆盖 v3/v4/v5。
• 纯 ELF 解析：不需要 DWARF 数据时用标准 ELF 工具即可。
• 运行时调试：调试可执行代码/运行时行为请用 gdb、lldb 等专用调试器。
• 二进制逆向：除非专门分析 DWARF 段，否则用 Ghidra、IDA 等逆向工具。
• 编译器问题：DWARF 生成缺陷与具体编译器相关，不在本技能范围。

步骤 / 指令

按需求选择路径：

┌─ 要校验 DWARF 数据完整性？
│   └─ 用 `llvm-dwarfdump --verify`（见下「校验工作流」）
├─ 要回答 DWARF 标准问题？
│   └─ 搜 dwarfstd.org，或参考 LLVM / libdwarf 源码
├─ 只需简单段转储或一般 ELF 信息？
│   └─ 用 `readelf`
├─ 要解析、搜索或转储 DWARF DIE 节点？
│   └─ 用 `dwarfdump`（比 readelf 更擅长复杂 DWARF，多数解析任务首选）
└─ 要写、改或审阅与 DWARF 交互的代码？
    └─ 参考下「编写代码」与权威源

权威来源（需要精确标准时查证，不要凭记忆）：

1. 官方 DWARF 标准 dwarfstd.org：用 web 搜索定位规范具体章节，如查询 DWARF5 DW_TAG_subprogram attributes site:dwarfstd.org。
2. LLVM 实现 llvm/lib/DebugInfo/DWARF/，可靠的参考实现，关键文件：
   • DWARFDie.cpp —— DIE 处理与属性访问
   • DWARFUnit.cpp —— 编译单元解析
   • DWARFDebugLine.cpp —— 行号信息
   • DWARFVerifier.cpp —— 校验逻辑
3. libdwarf：github.com/davea42/libdwarf-code，参考 C 实现，对 DWARF 数据结构处理详尽。

示例

结构校验（编译单元、DIE 关系、地址范围）：

# 校验 DWARF 结构
llvm-dwarfdump --verify <binary>

# 带完整错误输出与摘要
llvm-dwarfdump --verify --error-display=full <binary>

# 机读 JSON 错误摘要
llvm-dwarfdump --verify --verify-json=errors.json <binary>

质量指标（以 JSON 输出调试信息质量，便于跨编译器版本/优化级别对比）：

llvm-dwarfdump --statistics <binary>

常见校验场景：

• 编译后：分发前确认二进制含合法 DWARF。
• 对比构建：用 --statistics 检测调试信息质量回退。
• 排查调试器：定位导致调试器异常的畸形 DWARF。
• DWARF 工具开发：用已知正确的二进制验证解析器输出。

注意事项

• 多数 DWARF 专项解析优先 dwarfdump，它比 readelf 更能处理与展示复杂 DWARF 信息；readelf 用于一般 ELF 信息或简单段转储。
• 编写解析代码时，既可从零解析 DWARF 段，也可借助 libdwarf / pyelftools / gimli 等库；涉及具体 tag/attribute 语义时务必回查权威源核对。
• 仅在任务明确落在上述范围内时使用本技能。
• 输出不能替代环境相关的验证、测试或专家评审。
• 若缺少必要输入、权限、安全边界或成功判据，先停下来确认再继续。

互见

• related：与 ELF/二进制分析、编译工具链相关技能横向相关。
• combines_with：可与逆向分析、崩溃栈解析类技能组合，用 DWARF 还原源码级符号与行号。

---

采编自 sickn33/antigravity-awesome-skills（MIT）。