Struct gimli::DebugFrame
[−]
[src]
pub struct DebugFrame<'input, Endian>(_) where Endian: Endianity;DebugFrame contains the .debug_frame section's frame unwinding
information required to unwind to and recover registers from older frames on
the stack. For example, this is useful for a debugger that wants to print
locals in a backtrace.
Most interesting methods are defined in the
UnwindSection trait.
Differences between .debug_frame and .eh_frame
While the .debug_frame section's information has a lot of overlap with the
.eh_frame section's information, the .eh_frame information tends to only
encode the subset of information needed for exception handling. Often, only
one of .eh_frame or .debug_frame will be present in an object file.
Methods
impl<'input, Endian> DebugFrame<'input, Endian> where Endian: Endianity[src]
fn new(section: &'input [u8]) -> DebugFrame<'input, Endian>
Construct a new DebugFrame instance from the data in the
.debug_frame section.
It is the caller's responsibility to read the section and present it as
a &[u8] slice. That means using some ELF loader on Linux, a Mach-O
loader on OSX, etc.
use gimli::{DebugFrame, NativeEndian}; // Use with `.debug_frame` let debug_frame = DebugFrame::<NativeEndian>::new(read_debug_frame_section_somehow());
Trait Implementations
impl<'input, Endian: Clone> Clone for DebugFrame<'input, Endian> where Endian: Endianity[src]
fn clone(&self) -> DebugFrame<'input, Endian>
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)1.0.0
Performs copy-assignment from source. Read more
impl<'input, Endian: Copy> Copy for DebugFrame<'input, Endian> where Endian: Endianity[src]
impl<'input, Endian: Debug> Debug for DebugFrame<'input, Endian> where Endian: Endianity[src]
impl<'input, Endian: PartialEq> PartialEq for DebugFrame<'input, Endian> where Endian: Endianity[src]
fn eq(&self, __arg_0: &DebugFrame<'input, Endian>) -> bool
This method tests for self and other values to be equal, and is used by ==. Read more
fn ne(&self, __arg_0: &DebugFrame<'input, Endian>) -> bool
This method tests for !=.
impl<'input, Endian: Eq> Eq for DebugFrame<'input, Endian> where Endian: Endianity[src]
impl<'input, Endian> UnwindSection<'input, Endian> for DebugFrame<'input, Endian> where Endian: Endianity[src]
type Offset = DebugFrameOffset
The offset type associated with this CFI section. Either DebugFrameOffset or EhFrameOffset. Read more
fn offset(offset: usize) -> Self::Offset
Construct a Self::Offset.
fn entries<'bases>(&self,
bases: &'bases BaseAddresses)
-> CfiEntriesIter<'bases, 'input, Endian, Self>
bases: &'bases BaseAddresses)
-> CfiEntriesIter<'bases, 'input, Endian, Self>
Iterate over the CommonInformationEntrys and FrameDescriptionEntrys in this .debug_frame section. Read more
fn cie_from_offset<'bases>(&self,
bases: &'bases BaseAddresses,
offset: Self::Offset)
-> Result<CommonInformationEntry<'input, Endian, Self>>
bases: &'bases BaseAddresses,
offset: Self::Offset)
-> Result<CommonInformationEntry<'input, Endian, Self>>
Parse the CommonInformationEntry at the given offset.
fn unwind_info_for_address<'bases>(&self,
bases: &'bases BaseAddresses,
ctx: UninitializedUnwindContext<'input, Endian, Self>,
address: u64)
-> Result<(UnwindTableRow<'input, Endian>, UninitializedUnwindContext<'input, Endian, Self>)>
bases: &'bases BaseAddresses,
ctx: UninitializedUnwindContext<'input, Endian, Self>,
address: u64)
-> Result<(UnwindTableRow<'input, Endian>, UninitializedUnwindContext<'input, Endian, Self>)>
Find the frame unwind information for the given address. Read more