Struct pdb_addr2line::Context

pub struct Context<'a: 't, 's, 't> { /* fields omitted */ }

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

Implementations

impl<'a, 's, 't> Context<'a, 's, 't>

pub fn new_from_parts(
    address_map: &'a AddressMap<'s>,
    string_table: Option<&'a StringTable<'s>>,
    modules: &'a [ModuleInfo<'s>],
    type_formatter: MaybeOwned<'a, TypeFormatter<'t>>
) -> Result<Self>

Create a Context manually. Most consumers will want to use ContextPdbData::make_context instead.

However, if you interact with a PDB directly and parse some of its contents for other uses, you may want to call this method in order to avoid overhead from repeatedly parsing the same streams.

pub fn procedure_count(&self) -> usize

The number of procedures found in the modules. If the PDB file lists multiple procedures sharing the same rva range, the shared range is only counted as one procedure. In other words, this count is post-deduplication.

pub fn iter_procedures(&self) -> ProcedureIter<'_, 'a, 's, 't>

Iterate over all procedures in the modules.

pub fn find_procedure(&self, probe: u32) -> Result<Option<Procedure>>

Find the procedure (function or method) whose code contains the provided address. The return value only contains the function name and the rva range, but no file or line information.

pub fn find_frames(&self, probe: u32) -> Result<Option<ProcedureFrames<'_>>>

Find information about the source code which generated the instruction at the provided address. This information includes the function name, file name and line number, of the containing procedure and of any functions that were inlined into the procedure by the compiler, at that address.

A lot of information is cached so that repeated calls are fast.