LIEF PDB 调试信息解析:C++ API 全览与 `LIEF::pdb` 实战指南
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 构建:
- 通过 CMake 开启
-DLIEF_DEBUG_INFO=ON(该选项同时会把LIEF_EXTENDED置 1,见 cmake/LIEFOptions.cmake); - 检查运行时是否出现
DEBUG_FMT_NOT_SUPPORTED日志,出现即说明当前构建不含调试信息支持; - 调试信息能力需要从 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 解析与分析工具。