pdb2

此仓库是从 willglynn/pdb 分叉并发布为 pdb2 crate。

这是一个解析 Microsoft PDB (程序数据库) 文件的 Rust 库。这些文件包含大多数针对 Windows 的编译器产生的调试信息，包括符号、类型、模块等信息。

PDB 格式本身没有文档，但微软已以 C++ 代码的形式发布了有关其使用的信息。PDB 格式充满了...历史，包括对 16 位可执行文件的调试、COBOL 用户定义类型以及众多其他功能。 pdb2 并不完全理解 PDB 格式的所有内容，但它涵盖了足够的内容，足以适用于今天编译的典型程序。

docs.rs 上的文档.

设计

pdb2 的设计目标与 gimli 类似

• pdb2 尽可能地以磁盘上原始数据的格式工作。

• pdb2 仅解析您请求的内容。

• pdb2 可以在任何地方读取 PDB。不依赖于 Windows、DIA SDK 或目标的本地字节序。

使用示例

use pdb2::FallibleIterator;
use std::fs::File;

fn main() -> pdb2::Result<()> {
    let file = File::open("fixtures/self/foo.pdb")?;
    let mut pdb = pdb2::PDB::open(file)?;

    let symbol_table = pdb.global_symbols()?;
    let address_map = pdb.address_map()?;

    let mut symbols = symbol_table.iter();
    while let Some(symbol) = symbols.next()? {
        match symbol.parse() {
            Ok(pdb2::SymbolData::Public(data)) if data.function => {
                // we found the location of a function!
                let rva = data.offset.to_rva(&address_map).unwrap_or_default
                println!("{} is {}", rva, data.name);
            }
            _ => {}
        }
    }

    Ok(())
}

示例程序

使用 cargo run --release --example <name>