Trait gimli::UnwindSection
[−]
[src]
pub trait UnwindSection<R: Reader>: Clone + Debug + _UnwindSectionPrivate<R> { type Offset: UnwindOffset<R::Offset>; fn entries<'bases>(
&self,
bases: &'bases BaseAddresses
) -> CfiEntriesIter<'bases, Self, R> { ... } fn cie_from_offset<'bases>(
&self,
bases: &'bases BaseAddresses,
offset: Self::Offset
) -> Result<CommonInformationEntry<Self, R, R::Offset>> { ... } fn unwind_info_for_address<'bases>(
&self,
bases: &'bases BaseAddresses,
ctx: UninitializedUnwindContext<Self, R>,
address: u64
) -> UnwindResult<(UnwindTableRow<R>, UninitializedUnwindContext<Self, R>), UninitializedUnwindContext<Self, R>> { ... } }
A section holding unwind information: either .debug_frame
or
.eh_frame
. See DebugFrame
and
EhFrame
respectively.
Associated Types
type Offset: UnwindOffset<R::Offset>
The offset type associated with this CFI section. Either
DebugFrameOffset
or EhFrameOffset
.
Provided Methods
fn entries<'bases>(
&self,
bases: &'bases BaseAddresses
) -> CfiEntriesIter<'bases, Self, R>
&self,
bases: &'bases BaseAddresses
) -> CfiEntriesIter<'bases, Self, R>
Iterate over the CommonInformationEntry
s and FrameDescriptionEntry
s
in this .debug_frame
section.
Can be used with
FallibleIterator
.
fn cie_from_offset<'bases>(
&self,
bases: &'bases BaseAddresses,
offset: Self::Offset
) -> Result<CommonInformationEntry<Self, R, R::Offset>>
&self,
bases: &'bases BaseAddresses,
offset: Self::Offset
) -> Result<CommonInformationEntry<Self, R, R::Offset>>
Parse the CommonInformationEntry
at the given offset.
fn unwind_info_for_address<'bases>(
&self,
bases: &'bases BaseAddresses,
ctx: UninitializedUnwindContext<Self, R>,
address: u64
) -> UnwindResult<(UnwindTableRow<R>, UninitializedUnwindContext<Self, R>), UninitializedUnwindContext<Self, R>>
&self,
bases: &'bases BaseAddresses,
ctx: UninitializedUnwindContext<Self, R>,
address: u64
) -> UnwindResult<(UnwindTableRow<R>, UninitializedUnwindContext<Self, R>), UninitializedUnwindContext<Self, R>>
Find the frame unwind information for the given address.
If found, the unwind information is returned along with the reset
context in the form Ok((unwind_info, context))
. If not found,
Err(gimli::Error::NoUnwindInfoForAddress)
is returned. If parsing or
CFI evaluation fails, the error is returned.
use gimli::{BaseAddresses, EhFrame, EndianSlice, NativeEndian, UninitializedUnwindContext, UnwindSection}; // Get the `.eh_frame` section from the object file. Alternatively, // use `EhFrame` with the `.eh_frame` section of the object file. let eh_frame = EhFrame::new(read_eh_frame_section(), NativeEndian); // Get the address of the PC for a frame you'd like to unwind. let address = get_frame_pc(); // This context is reusable, which cuts down on heap allocations. let ctx = UninitializedUnwindContext::new(); // Optionally provide base addresses for any relative pointers. If a // base address isn't provided and a pointer is found that is relative to // it, we will return an `Err`. let bases = BaseAddresses::default() .set_text(address_of_text_section_in_memory) .set_data(address_of_data_section_in_memory); let (unwind_info, ctx) = eh_frame.unwind_info_for_address(&bases, ctx, address) .map_err(|(err, ctx)| { // Recover the uninitialized `ctx` to reuse it in future unwinding. recover(ctx); err })?; do_stuff_with(unwind_info);
Implementors
impl<R: Reader> UnwindSection<R> for DebugFrame<R> type Offset = DebugFrameOffset<R::Offset>;
impl<R: Reader> UnwindSection<R> for EhFrame<R> type Offset = EhFrameOffset<R::Offset>;