Struct gimli::DebugFrame
[−]
[src]
pub struct DebugFrame<R: Reader>(_);
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<EndianBuf<'input, Endian>> where
Endian: Endianity,
[src]
Endian: Endianity,
fn new(section: &'input [u8], endian: Endian) -> Self
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::new(read_debug_frame_section_somehow(), NativeEndian);
Trait Implementations
impl<R: Clone + Reader> Clone for DebugFrame<R>
[src]
fn clone(&self) -> DebugFrame<R>
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<R: Copy + Reader> Copy for DebugFrame<R>
[src]
impl<R: Debug + Reader> Debug for DebugFrame<R>
[src]
impl<R: PartialEq + Reader> PartialEq for DebugFrame<R>
[src]
fn eq(&self, __arg_0: &DebugFrame<R>) -> bool
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, __arg_0: &DebugFrame<R>) -> bool
This method tests for !=
.
impl<R: Eq + Reader> Eq for DebugFrame<R>
[src]
impl<R: Reader> Section<R> for DebugFrame<R>
[src]
fn section_name() -> &'static str
Returns the ELF section name for this type.
impl<R: Reader> From<R> for DebugFrame<R>
[src]
fn from(section: R) -> Self
Performs the conversion.
impl<R: Reader> UnwindSection<R> for DebugFrame<R>
[src]
type Offset = DebugFrameOffset<R::Offset>
The offset type associated with this CFI section. Either DebugFrameOffset
or EhFrameOffset
. Read more
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. Read more
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
) -> Result<(UnwindTableRow<R>, UninitializedUnwindContext<Self, R>)>
&self,
bases: &'bases BaseAddresses,
ctx: UninitializedUnwindContext<Self, R>,
address: u64
) -> Result<(UnwindTableRow<R>, UninitializedUnwindContext<Self, R>)>
Find the frame unwind information for the given address. Read more