pdb

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

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

在 docs.rs 上的文档.

设计

pdb 的设计目标与 gimli 类似

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

• pdb 只解析您所请求的内容。

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

使用示例

use pdb::FallibleIterator;
use std::fs::File;

fn main() -> pdb::Result<()> {
    let file = File::open("fixtures/self/foo.pdb")?;
    let mut pdb = pdb::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(pdb::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>