[][src]Struct addr2line::Context

pub struct Context<R = EndianRcSlice<RunTimeEndian>> where
    R: Reader
{ /* fields omitted */ }

The state necessary to perform address to line translation.

Constructing a Context is somewhat costly, so users should aim to reuse Contexts when performing lookups for many addresses in the same executable.

Methods

impl Context<EndianRcSlice<RunTimeEndian>>[src]

pub fn new<'data, 'file, O: Object<'data, 'file>>(
    file: &'file O
) -> Result<Self, Error>
[src]

Construct a new Context.

The resulting Context uses gimli::EndianRcSlice<gimli::RunTimeEndian>. This means it is not thread safe, has no lifetime constraints (since it copies the input data), and works for any endianity.

Performance sensitive applications may want to use Context::from_sections with a more specialised gimli::Reader implementation.

impl<R: Reader> Context<R>[src]

pub fn from_sections(
    debug_abbrev: DebugAbbrev<R>,
    debug_addr: DebugAddr<R>,
    debug_info: DebugInfo<R>,
    debug_line: DebugLine<R>,
    debug_line_str: DebugLineStr<R>,
    debug_ranges: DebugRanges<R>,
    debug_rnglists: DebugRngLists<R>,
    debug_str: DebugStr<R>,
    debug_str_offsets: DebugStrOffsets<R>,
    default_section: R
) -> Result<Self, Error>
[src]

Construct a new Context from DWARF sections.

impl<R> Context<R> where
    R: Reader
[src]

pub fn find_location(&self, probe: u64) -> Result<Option<Location>, Error>[src]

Find the source file and line corresponding to the given virtual memory address.

pub fn find_frames(&self, probe: u64) -> Result<FrameIter<R>, Error>[src]

Return an iterator for the function frames corresponding to the given virtual memory address.

If the probe address is not for an inline function then only one frame is returned.

If the probe address is for an inline function then the first frame corresponds to the innermost inline function. Subsequent frames contain the caller and call location, until an non-inline caller is reached.

Auto Trait Implementations

impl<R> Send for Context<R> where
    R: Send,
    <R as Reader>::Offset: Send

impl<R = EndianReader<RunTimeEndian, Rc<[u8]>>> !Sync for Context<R>

Blanket Implementations

impl<T, U> TryFrom for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> Into for T where
    U: From<T>, 
[src]

impl<T> From for T[src]

impl<T, U> TryInto for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> Borrow for T where
    T: ?Sized
[src]

impl<T> BorrowMut for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]