LIEF PDB 调试信息解析:C++ API 全览与 `LIEF::pdb` 实战指南

原创2026-10-11 23:35:151,631 阅读
文章标签:逆向工程开发工具

LIEF PDB 调试信息解析:C++ API 全览与 LIEF::pdb 实战指南

导读

LIEF 的 Extended 扩展模块提供了对 Windows PDB(Program Database)调试信息的解析能力。PDB 与 DWARF 不同,它总是作为独立文件保存在二进制之外,仅由 PE 文件中的 CodeView 记录指向其路径。本文聚焦 LIEF 为 C++ 使用者提供的 LIEF::pdb 命名空间:从 load() 加载 PDB、通过 DebugInfo 遍历编译单元(CompilationUnit)、公共符号(PublicSymbol)、函数(Function)与类型(Type),再到利用 to_decl() 把类型和函数还原成 C/C++ 声明,是一份面向逆向工程与二进制分析开发者的 API 使用指南。

阅读本文后,你将掌握:PDB 调试信息的两种挂载方式(LIEF::pdb::load 与 Binary::load_debug_info)、DebugInfo 核心查询接口、PDB 类型系统的完整类层次(LIEF::pdb::types),以及通过 DeclOpt 定制 C/C++ 声明生成的方法。文中所有接口语义均来自 include/LIEF/PDB/ 下的头文件声明,使用范式来自官方示例 doc/code/cpp/pdb.cpp,行为预期由 tests/pdb/ 中的测试用例印证。

构建前提(务必先读):PDB 支持属于 LIEF Extended 功能,由 CMake 选项 LIEF_DEBUG_INFO 控制(见 cmake/LIEFOptions.cmake)。当构建未开启该选项时,本模块的所有实现均为占位 stub:DebugInfo::from_file / load() 返回 nullptr,并在日志中输出 DEBUG_FMT_NOT_SUPPORTED("Debug info not available for this build.",见 src/messages.hpp 与 src/PDB/pdb.cpp)。因此下面的示例均以启用了 Extended 的构建为前提。

加载 PDB:LIEF::pdb::load 与 DebugInfo::from_file

入口函数与判定工具

LIEF::pdb 命名空间暴露两个最常用的工具函数,声明于 include/LIEF/PDB/utils.hpp 与 include/LIEF/PDB/DebugInfo.hpp:

// 判定给定路径是否指向一个 PDB 文件
bool is_pdb(std::string_view pdb_path);

// 加载 PDB 文件,失败时返回 nullptr
std::unique_ptr<DebugInfo> load(std::string_view pdb_path);

其中 load() 只是 DebugInfo::from_file(pdb_path) 的轻量 inline 封装(include/LIEF/PDB/DebugInfo.hpp):

inline std::unique_ptr<DebugInfo> load(std::string_view pdb_path) {
  return DebugInfo::from_file(pdb_path);
}

is_pdb 常用于在加载前做快速预判,避免把非 PDB 文件送入解析流程;测试 tests/pdb/test_api.py 中的用法为 assert lief.is_pdb(get_sample("PDB/ntkrnlmp.pdb")),C++ 侧对应 LIEF::pdb::is_pdb(path)。

从 PE 的 CodeView 记录自动关联

PDB 与 DWARF 最大的区别在于:调试信息始终独立存储于二进制之外。PE 文件本身只通过 CodeView PDB 记录(lief-pe-codeviewpdb-filename)保存 PDB 文件的路径。基于这一事实,抽象层 LIEF::Binary::debug_info() 会尝试用该路径自动实例化 DebugInfo;失败时返回 nullptr。官方示例 doc/code/cpp/pdb.cpp 展示了两种途径:

void load_pdb() {
  std::unique_ptr<LIEF::PE::Binary> pe;

  // 方式一:通过 PE 的 CodeView PDB 记录自动关联
  if (const LIEF::DebugInfo* info = pe->debug_info()) {
    assert(LIEF::pdb::DebugInfo::classof(info) && "Wrong DebugInfo type");
    const auto& pdb = static_cast<const LIEF::pdb::DebugInfo&>(*info);
  }

  // 方式二:直接加载 PDB 文件
  std::unique_ptr<LIEF::pdb::DebugInfo> pdb = LIEF::pdb::load("some.pdb");
  (void)pdb;
}

注意示例中的 LIEF::pdb::DebugInfo::classof(info) 断言:DebugInfo 继承自抽象层 include/LIEF/Abstract/DebugInfo.hpp,其 format() 恒返回 LIEF::DebugInfo::FORMAT::PDB(include/LIEF/PDB/DebugInfo.hpp),classof 据此完成运行时类型判定,这是把 LIEF::DebugInfo* 向下转型为 PDB 专用类型的安全手段。

将外部 PDB 挂载到二进制

即使 PE 文件中没有可用的 CodeView 路径,也可以用 Binary::load_debug_info() 把 PDB 手动挂载到已解析的二进制上(include/LIEF/Abstract/Binary.hpp):

void load_ext() {
  std::unique_ptr<LIEF::Binary> binary;
  binary->load_debug_info(R"(C:\Users\romain\LIEF.pdb)");
}

该接口同样可以给 PE 挂载外部的 DWARF 调试文件(虽然这不是典型用法),例如 BinaryNinja / Ghidra 的 DWARF 导出插件就可以为 PE 生成 DWARF 后再加载。挂载之后,反汇编器可以利用这份新增的调试信息,按函数名反汇编调试文件中定义的函数:

void disassemble() {
  std::unique_ptr<LIEF::Binary> binary;
  binary->load_debug_info(R"(C:\Users\romain\LIEF.pdb)");

  // my_function 的地址/大小定义在 LIEF.pdb 中
  for (const LIEF::assembly::Instruction& inst :
       binary->disassemble("my_function"))
  {
    std::cout << inst << '\n';
  }
}

disassemble(const std::string&) 按名称解析函数地址的重载声明于 include/LIEF/Abstract/Binary.hpp,其地址解析正是借助 PDB 提供的函数位置信息。测试 tests/pdb/test_api.py 验证了端到端流程:对 LIEF-arm64.dll 执行 load_debug_info 后,pe.debug_info 变为 lief.pdb.DebugInfo 类型,且能对 PDB 中的函数名反汇编出 9538 条指令。

DebugInfo:PDB 的顶层视图

LIEF::pdb::DebugInfo 是 PDB 文件的统一入口对象,声明于 include/LIEF/PDB/DebugInfo.hpp。它提供三类迭代器与若干查询接口:

成员 返回类型 语义
compilation_units() compilation_units_it 遍历 DBI 流中的编译单元(PDB 官方文档中也称为 "Module")
public_symbols() public_symbols_it 遍历公共符号流(public symbol stream)中的符号
types() types_it 遍历 PDB 中注册的全部类型
find_type(name) std::unique_ptr<Type> 按名称查找类型,未找到返回 nullptr
find_type(index) std::unique_ptr<Type> 按类型索引查找
find_public_symbol(name) std::unique_ptr<PublicSymbol> 基于公共符号流按名查找符号,未找到返回 nullptr
find_function_address(name) std::optional<uint64_t> 解析指定函数名的地址(override 自抽象层)
age() uint32_t PDB 文件被写入的次数
guid() std::string PDB 文件的唯一标识符
to_string() std::string 可读的文本表示(配合 operator<< 输出)

find_public_symbol 的头文件注释给出了典型用法(include/LIEF/PDB/DebugInfo.hpp):

const DebugInfo& info = ...;
if (auto found = info.find_public_symbol("MiSyncSystemPdes")) {
  // FOUND!
}

测试 tests/pdb/test_api.py 印证了这些接口的真实数据形态:ntkrnlmp.pdb 的 age == 5、guid == "bf9e1903-5978-4c2d-8796-cf5537b238b4",find_public_symbol("MiSyncSystemPdes") 得到的符号位于 .text 段、RVA == 0xED40。

浏览 PDB 信息

官方示例 doc/code/cpp/pdb.cpp 给出了一个完整的"探索"骨架,覆盖了 DebugInfo 下所有核心迭代:

void explore() {
  std::unique_ptr<LIEF::pdb::DebugInfo> pdb;
  log(Level::Info, "age={}, guid={}", std::to_string(pdb->age()), pdb->guid());

  for (const LIEF::pdb::PublicSymbol& symbol : pdb->public_symbols()) {
    log(Level::Info, "name={}, section={}, RVA={}", symbol.name(),
        symbol.section_name(), std::to_string(symbol.RVA()));
  }

  for (const LIEF::pdb::Type& ty : pdb->types()) {
    if (LIEF::pdb::types::Class::classof(&ty)) {
      const auto* clazz = ty.as<LIEF::pdb::types::Class>();
      log(Level::Info, "Class[name]={}", clazz->name().value_or(""));
    }
  }

  for (const LIEF::pdb::CompilationUnit& CU : pdb->compilation_units()) {
    log(Level::Info, "module={}", CU.module_name());
    for (const std::string& src : CU.sources()) {
      log(Level::Info, "  - {}", src);
    }

    for (const LIEF::pdb::Function& func : CU.functions()) {
      log(Level::Info, "name={}, section={}, RVA={}, code size={}", func.name(),
          func.section_name(), std::to_string(func.RVA()),
          std::to_string(func.code_size()));
    }
  }
}

这里体现了两个重要的设计点:

  • 类型判断使用 classof + as<T>()。Type::as<T>() 内部调用 T::classof(this) 做 kind 检查后安全转型(include/LIEF/PDB/Type.hpp),失败返回 nullptr,无需手动 static_cast。
  • 迭代器都是惰性视图。DebugInfo 返回的 compilation_units_it、public_symbols_it、types_it 是基于 Iterator 的 iterator_range,对应的迭代器实现(CompilationUnit::Iterator、PublicSymbol::Iterator、Type::Iterator)支持 operator++/operator--(编译单元为双向迭代器)或 operator++(符号/类型为前向迭代器),并额外提供 yield() 用于把当前位置元素的所有权转移给调用方(返回 nullptr 表示已越过末尾)。

PublicSymbol:公共符号流

LIEF::pdb::PublicSymbol 描述公共符号流(Public symbol hash stream)中的符号,声明于 include/LIEF/PDB/PublicSymbol.hpp。其核心成员:

成员 返回类型 语义
name() std::string_view 符号名
demangled_name() std::string 符号的反修饰(demangled)表示
section_name() std::string 符号所在节名(如 .text),找不到时返回空串
RVA() uint32_t 符号的相对虚拟地址,无法计算时返回 0

头文件还定义了一个位标志枚举 FLAGS(CODE、FUNCTION、MANAGED、MSIL),用于刻画符号的属性。测试 tests/pdb/test_api.py 给出了非常直观的数据形态:ntkrnlmp.pdb 公共符号流中共 18670 个符号;第 0 个符号 MiSyncSystemPdes 的 demangled_name 与 name 相同;第 18669 个符号是 MSVC 修饰名 ??_C@_0CC@KGNKJKHE@heap_failure_listentry_corruptio@FNODOBFM@,其 demangled_name 还原为 "heap_failure_listentry_corruptio"...。这说明 demangled_name() 对 C++ 修饰名做了实际还原,是分析 Windows 二进制导出/引用符号的重要工具。

CompilationUnit:编译单元(Module)

CompilationUnit 对应 PDB 中的编译单元(官方文档称 Module),声明于 include/LIEF/PDB/CompilationUnit.hpp。其接口如下:

成员 返回类型 语义
module_name() std::string_view 关联 COFF 目标文件(.obj)的名称或路径,如 e:\obj.amd64fre\minkernel\ntos\hvl\mp\objfre\amd64\hvlp.obj
object_filename() std::string_view 链接前该编译单元所在原始目标文件(COFF/Archive)的路径,如 ...\hvl.lib
sources() sources_iterator 组成该编译单元的源文件迭代器,包含头文件(.h、.hpp 等)
functions() function_iterator 该编译单元内定义的函数;若 PDB 没有或 DBI 流为空,返回空迭代器
build_metadata() std::unique_ptr<BuildMetadata> 构建元数据(编译器版本、源语言等)
to_decl(opt) std::string 为该编译单元中的函数生成 C/C++ 声明
to_string() std::string 可读文本表示

测试 tests/pdb/test_api.py 展示了编译单元的现实形态:ntkrnlmp.pdb 共 1058 个编译单元,第 0 个是特殊单元 * CIL *,第 600 个是 kernelva.obj(object_filename 指向 mm.lib),最后一个往往是 * Linker *。libobjc2.pdb 的 * Linker * 单元(units[2])的 sources() 还能还原出原始 .def 文件路径,验证了"源文件包含头文件/def 文件"的语义。

functions() 的粒度由测试 tests/pdb/test_api.py 验证:libobjc2.pdb 单元 3 中 objc_exception_throw 的 RVA == 0x13F00、code_size == 0x6B0、位于 .text 段;debug_location() 还能还原出原始源码位置,例如 objc_exception_throw 指向 eh_win32_msvc.cc:95。这为"由调试信息恢复符号化调用链"提供了数据基础。

BuildMetadata:构建元数据

BuildMetadata 封装 CodeView 符号 S_COMPILE3、S_COMPILE2、S_BUILDINFO、S_ENVBLOCK 所携带的构建信息,声明于 include/LIEF/PDB/BuildMetadata.hpp。它定义了三个内嵌结构/枚举:

  • version_t:由 major、minor、build、qfe 四个 uint16_t 组成的版本号;
  • build_info_t:S_BUILDINFO 符号携带的信息,字段为 cwd(构建工具的工作目录)、build_tool(构建工具路径,如 ...\HostX64\x64\CL.exe)、source_file、pdb(PDB 路径)、command_line(构建命令行);
  • LANG 枚举:源语言,覆盖 C、CPP、FORTRAN、MASM、CSHARP、JAVA、OBJC、SWIFT、RUST、GO 等,未知为 UNKNOWN;
  • CPU 枚举:目标 CPU,覆盖 INTEL_8080 到 ARM64EC、X64、D3D11_SHADER 等大量平台。

对外访问接口:

成员 返回类型 语义
frontend_version() version_t 前端版本(如 19.36.32537)
backend_version() version_t 后端版本(如 14.36.32537)
version() std::string_view 工具版本字符串,如 Microsoft (R) CVTRES、Microsoft (R) LINK
language() LANG 源语言
target_cpu() CPU 目标 CPU
build_info() std::optional<build_info_t> S_BUILDINFO 信息,可能为空
env() std::vector<std::string> S_ENVBLOCK 环境信息(键值成对出现)

此外命名空间级提供了 to_string(BuildMetadata::CPU) 与 to_string(BuildMetadata::LANG) 两个重载,用于枚举的可读输出。

测试 tests/pdb/test_build_metadata.py 提供了非常有说服力的真实数据:LIEF 自身构建产物 LIEF.pdb 的 434 个编译单元中,单元 0 是 MSVC 优化编译器(backend_version = 19.36.32537、LANG::CPP、CPU::X64),单元 425 是 CVTRES 工具,单元 433 是 * Linker *(version == "Microsoft (R) LINK"),其 env() 还原出完整的环境键值对(cwd、exe、pdb、cmd 及其值),单元 424 的 build_info().command_line 则完整记录了编译时的全部命令行参数。这些数据表明 BuildMetadata 可以用于恢复二进制的可复现构建信息。

Function:函数信息

LIEF::pdb::Function 描述编译单元内定义的函数,声明于 include/LIEF/PDB/Function.hpp。与 LIEF::pdb::types::Function(函数类型)不同,它描述的是函数实例:

成员 返回类型 语义
name() std::string_view 函数名(通常已反修饰)
RVA() uint32_t 函数的相对虚拟地址
code_size() uint32_t 函数代码大小
section_name() std::string 函数所在节名
debug_location() debug_location_t 原始源码位置(文件 + 行号)
to_decl(opt) std::string 生成该函数的 C/C++ 声明
to_string() std::string 可读文本表示

debug_location_t 定义于 include/LIEF/debug_loc.hpp,携带 file 与 line 字段。测试 tests/pdb/test_api.py 验证了 debug_location() 能精确还原到 eh_win32_msvc.cc:95、xstring:4004 这样的源码坐标。

Type 与 types 命名空间:PDB 类型系统

基类 LIEF::pdb::Type

Type 是所有 PDB 类型的基类(include/LIEF/PDB/Type.hpp),提供:

  • KIND 枚举:UNKNOWN、CLASS、POINTER、SIMPLE、ENUM、FUNCTION、MODIFIER、BITFIELD、ARRAY、UNION、STRUCTURE、INTERFACE,由 kind() 返回;
  • name():std::optional<std::string>,类型名(若存在);
  • size():std::optional<uint64_t>,类型大小,应等于对该类型应用 sizeof(...) 的结果;
  • to_decl(opt):生成该类型的 C/C++ 定义;
  • as<T>():安全向下转型,内部依赖各子类的 classof()。

子类全部位于 LIEF::pdb::types 命名空间,聚合头为 include/LIEF/PDB/types.hpp(#include <LIEF/PDB.hpp> 即包含全部)。每个子类都与 CodeView 类型记录一一对应:

类 对应 CodeView 记录 核心成员
types::Simple 原始类型(simple types) type() 返回 TYPES 枚举(VOID_、SCHAR、UCHAR、FLOAT32、BOOL8 等),modes() 返回 MODES 枚举(DIRECT、NEAR_POINTER64 等),另有 is_pointer() / is_signed() 便捷判断
types::Array LF_ARRAY numberof_elements()、element_type()、index_type()
types::BitField LF_BITFIELD 位域类型,无额外公开字段
types::ClassLike LF_STRUCTURE / LF_INTERFACE / LF_CLASS / LF_UNION unique_name()(修饰名)、attributes()、methods()
types::Structure LF_STRUCTURE 继承 ClassLike
types::Class LF_CLASS 继承 ClassLike
types::Interface LF_INTERFACE 继承 ClassLike
types::Union LF_UNION 继承 ClassLike
types::Enum LF_ENUM unique_name()、entries()(Entry 列表)、underlying_type()、find_entry(value)
types::Function LF_PROCEDURE return_type()、parameters()(vector<unique_ptr<Type>>)
types::Modifier LF_MODIFIER underlying_type()(被修饰的底层类型,如 const/volatile)
types::Pointer LF_POINTER underlying_type()(被指向的类型)

聚合类型成员:Attribute 与 Method

ClassLike 的成员通过以下两个类刻画(与 ClassLike 同处 LIEF::pdb::types 命名空间):

  • Attribute(include/LIEF/PDB/types/Attribute.hpp):对应聚合体中的 LF_MEMBER,提供 name()、type()(成员类型)、field_offset()(成员在聚合体中的偏移)。
  • Method(include/LIEF/PDB/types/Method.hpp):对应 LF_ONEMETHOD,提供 name()、type()(TYPE 枚举:VANILLA、VIRTUAL、STATIC、FRIEND、INTRODUCING_VIRTUAL、PURE_VIRTUAL、PURE_INTRODUCING_VIRTUAL)、access()(ACCESS 枚举:PRIVATE、PROTECTED、PUBLIC)。

Simple 类型的细节

types::Simple 的 TYPES 枚举完整覆盖 CodeView 简单类型索引(include/LIEF/PDB/types/Simple.hpp):从 SCHAR/UCHAR、SSHORT/USHORT、SLONG/ULONG、SQUAD/UQUAD 到显式的 SINT16/UINT16…SINT128/UINT128,以及 FLOAT16 到 FLOAT128、复数 COMPLEX*、布尔 BOOL8…BOOL128。MODES 枚举刻画指针属性(NEAR_POINTER32、NEAR_POINTER64、FAR_POINTER32 等)。组合使用即可还原出 char*、int[10]、float& 这类 C/C++ 类型表达式。

枚举(Enum)的用法

types::Enum 的 Entry 内嵌类由 name() 与 value()(int64_t)组成(include/LIEF/PDB/types/Enum.hpp);entries() 返回 std::vector<Entry>,find_entry(int64_t) 支持按值反查枚举项,underlying_type() 给出承载枚举的底层整数类型。

生成 C/C++ 声明:to_decl() 与 DeclOpt

PDB 中的类型、函数与编译单元都可以通过 to_decl() 转成 C/C++ 定义,对应三个入口(include/LIEF/PDB/Type.hpp、include/LIEF/PDB/Function.hpp、include/LIEF/PDB/CompilationUnit.hpp):

  • LIEF::pdb::Type::to_decl(const DeclOpt&)
  • LIEF::pdb::Function::to_decl(const DeclOpt&)
  • LIEF::pdb::CompilationUnit::to_decl(const DeclOpt&)(生成该编译单元内函数的声明)

生成行为由 LIEF::DeclOpt 配置(include/LIEF/DebugDeclOpt.hpp),这是一个同时服务于 DWARF 与 PDB 的通用选项结构,主要选项如下:

选项 类型/默认 语义
indentation(value) uint32_t 缩进空格数
is_cpp(value) bool 优先使用 C++ 语法(如 bool 关键字)而非 C 语法
show_extended_annotations(value) bool 输出包含内存地址、偏移、类型大小、源码位置等底层细节的注释
include_types(value) bool 输出包含结构体/枚举/联合体的完整定义
include_locals(value) bool 为函数体输出局部/栈变量列表
desugar(value) bool 解析类型别名(sugar),如 uint32_t 可能展开为 unsigned int
show_field_offsets(value) bool 每个结构体成员前缀其字节偏移(/* 0x00 */ int A;)
type_aliases(map) / add_type_alias(name, alias) unordered_map<string,string> 类型名到友好别名的映射,如把 std::basic_string<...> 映射为 std::string
target_triple(triple) string_view LLVM 目标三元组(如 aarch64-unknown-linux-gnu),决定内建类型大小与寄存器注释命名;默认从二进制推断

官方示例 doc/code/cpp/pdb.cpp 给出了完整用法:

void to_decl() {
  std::unique_ptr<LIEF::pdb::DebugInfo> pdb;

  LIEF::DeclOpt opt;
  opt.is_cpp(true);

  for (const LIEF::pdb::Type& ty : pdb->types()) {
    std::cout << ty.to_decl(opt) << '\n';
  }

  for (const LIEF::pdb::CompilationUnit& CU : pdb->compilation_units()) {
    std::cout << CU.to_decl(opt) << '\n';
    for (const LIEF::pdb::Function& func : CU.functions()) {
      std::cout << func.to_decl(opt) << '\n';
    }
  }
}

这一能力是"把 PDB 调试信息还原为可编译头文件"的核心:对 ntkrnlmp.pdb 这类内核 PDB,可以自动重建出结构体布局(配合 show_field_offsets)、枚举常量与方法签名,直接服务于逆向工程中的类型重建工作流。测试 tests/pdb/test_pdb_to_decl.py 与 tests/pdb/test_pdb_types.py 进一步覆盖了各类 PDB 类型在 to_decl 下的输出形态。

当前仓库实现状态与构建提示

必须再次强调本文开头的构建前提:在默认(非 Extended)构建中,PDB 模块的 C++ 实现是占位桩。具体证据如下:

  • src/PDB/pdb.cpp 中 DebugInfo::from_file、is_pdb 均直接输出 LIEF_ERR(DEBUG_FMT_NOT_SUPPORTED) 并返回 nullptr/false;其余所有方法返回默认值(空迭代器、0、空字符串等),find_type、find_public_symbol、build_metadata 等返回 nullptr。
  • 抽象层 src/Abstract/debug_info.cpp 中 Binary::debug_info() 与 Binary::load_debug_info() 同样是 stub(DEBUG_FMT_NOT_SUPPORTED)。
  • 该错误宏定义于 src/messages.hpp,文案为 "Debug info not available for this build. Please checkout .../extended/intro.html for the details",提示需要 Extended 构建。

也就是说,仓库当前这份源码保留的是 PDB 模块的 API 骨架与头文件级契约,而真正的解析实现与测试数据(ntkrnlmp.pdb、libobjc2.pdb、LIEF.pdb 等样本)由启用 LIEF_DEBUG_INFO 的 Extended 构建提供;tests/pdb/ 中的测试文件也以 if not lief.__extended__: pytest.skip(...) 显式跳过非 Extended 环境(见 tests/pdb/test_api.py)。

因此,在实际使用中请确认你的 LIEF 构建:

  1. 通过 CMake 开启 -DLIEF_DEBUG_INFO=ON(该选项同时会把 LIEF_EXTENDED 置 1,见 cmake/LIEFOptions.cmake);
  2. 检查运行时是否出现 DEBUG_FMT_NOT_SUPPORTED 日志,出现即说明当前构建不含调试信息支持;
  3. 调试信息能力需要从 LIEF 官方渠道获取带 Extended 特性的构建产物(README 的 特性列表 将 DWARF/PDB 列为 Extended 功能,并注明其获取地址)。

小结

LIEF::pdb 为 C++ 开发者提供了一套结构清晰的 PDB 解析 API:

  • 入口:LIEF::pdb::load() / DebugInfo::from_file() 直接加载;Binary::debug_info() 通过 PE 的 CodeView 记录自动关联;Binary::load_debug_info() 手动挂载外部 PDB;
  • 顶层视图:DebugInfo 统一提供编译单元、公共符号、类型三大迭代器,以及按名查找类型/符号、解析函数地址等查询;
  • 实体模型:CompilationUnit(含 BuildMetadata)、PublicSymbol、Function 分别刻画编译单元、符号与函数;
  • 类型模型:Type 基类 + LIEF::pdb::types 下 12 个类型类完整映射 CodeView 的简单类型、数组、位域、类/结构/联合/接口、枚举、函数原型、修饰符与指针;
  • 输出能力:Type::to_decl()、Function::to_decl()、CompilationUnit::to_decl() 配合 DeclOpt,可把调试信息还原为 C/C++ 声明。

需要持续留意的是:以上 API 契约在 include/LIEF/PDB/ 头文件中完整定义,但可运行的解析实现仅存在于开启 LIEF_DEBUG_INFO 的 Extended 构建中。结合 doc/code/cpp/pdb.cpp 的示例与 tests/pdb/ 的测试预期,你可以基于本文的接口清单快速搭建自己的 PDB 解析与分析工具。

登录后查看全文
LIEF