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> Section<'input> for DebugFrame<'input, Endian> where Endian: Endianity
[src]
fn section_name() -> &'static str
Returns the ELF section name for this type.
impl<'input, Endian> From<&'input [u8]> 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 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<'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