Crate pdb_addr2line[][src]

Expand description

Resolve addresses to f function: (), file: (), line: () function: (), file: (), line: () function: (), file: (), line: () unction names, and to file name and line number information, with the help of a PDB file. Inline stacks are supported.

The API of this crate is intended to be similar to the API of the addr2line crate; the two Context APIs have comparable functionality. This crate is for PDB files whereas addr2line is for DWARF data (which is used in ELF and mach-o binaries, for example).

This crate also has a TypeFormatter API which can be used to get function signature strings independently from a Context.

To create a Context, use ContextPdbData.

Example

use pdb_addr2line::pdb;

fn look_up_addresses<'s, S: pdb::Source<'s> + 's>(stream: S, addresses: &[u32]) -> pdb::Result<()> {
    let mut pdb = pdb::PDB::open(stream)?;
    let context_data = pdb_addr2line::ContextPdbData::try_from_pdb(&mut pdb)?;
    let context = context_data.make_context()?;

    for address in addresses {
        if let Some(procedure_frames) = context.find_frames(*address)? {
            eprintln!("0x{:x} - {} frames:", address, procedure_frames.frames.len());
            for frame in procedure_frames.frames {
                let line_str = frame.line.map(|l| format!("{}", l));
                eprintln!(
                    "     {} at {}:{}",
                    frame.function.as_deref().unwrap_or("<unknown>"),
                    frame.file.as_deref().unwrap_or("??"),
                    line_str.as_deref().unwrap_or("??"),
                )
            }
        } else {
            eprintln!("{:x} - no frames found", address);
        }
    }
    Ok(())
}

Re-exports

pub use maybe_owned;
pub use pdb;

Structs

Context

The main API of this crate. Resolves addresses to function information.

ContextPdbData

Allows to easily create a Context directly from a pdb::PDB.

Frame

One frame of the inline stack at the looked-up address.

Function

Basic information about a function.

FunctionFrames

The result of an address lookup from Context::find_frames.

FunctionIter

An iterator over all functions in a Context.

TypeFormatter

Allows printing function signatures, for example for use in stack traces.

TypeFormatterFlags

Flags for TypeFormatter.

Enums

Error