Struct gimli::read::DebugAbbrev
source · [−]pub struct DebugAbbrev<R> { /* private fields */ }
Expand description
The DebugAbbrev
struct represents the abbreviations describing
DebuggingInformationEntry
s’ attribute names and forms found in the
.debug_abbrev
section.
Implementations
sourceimpl<'input, Endian> DebugAbbrev<EndianSlice<'input, Endian>> where
Endian: Endianity,
impl<'input, Endian> DebugAbbrev<EndianSlice<'input, Endian>> where
Endian: Endianity,
sourcepub fn new(debug_abbrev_section: &'input [u8], endian: Endian) -> Self
pub fn new(debug_abbrev_section: &'input [u8], endian: Endian) -> Self
Construct a new DebugAbbrev
instance from the data in the .debug_abbrev
section.
It is the caller’s responsibility to read the .debug_abbrev
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::{DebugAbbrev, LittleEndian};
let debug_abbrev = DebugAbbrev::new(read_debug_abbrev_section_somehow(), LittleEndian);
sourceimpl<R: Reader> DebugAbbrev<R>
impl<R: Reader> DebugAbbrev<R>
sourcepub fn abbreviations(
&self,
debug_abbrev_offset: DebugAbbrevOffset<R::Offset>
) -> Result<Abbreviations>
pub fn abbreviations(
&self,
debug_abbrev_offset: DebugAbbrevOffset<R::Offset>
) -> Result<Abbreviations>
Parse the abbreviations at the given offset
within this
.debug_abbrev
section.
The offset
should generally be retrieved from a unit header.
sourceimpl<T> DebugAbbrev<T>
impl<T> DebugAbbrev<T>
sourcepub fn borrow<'a, F, R>(&'a self, borrow: F) -> DebugAbbrev<R> where
F: FnMut(&'a T) -> R,
pub fn borrow<'a, F, R>(&'a self, borrow: F) -> DebugAbbrev<R> where
F: FnMut(&'a T) -> R,
Create a DebugAbbrev
section that references the data in self
.
This is useful when R
implements Reader
but T
does not.
Example Usage
// Read the DWARF section into a `Vec` with whatever object loader you're using.
let owned_section: gimli::DebugAbbrev<Vec<u8>> = load_section();
// Create a reference to the DWARF section.
let section = owned_section.borrow(|section| {
gimli::EndianSlice::new(§ion, gimli::LittleEndian)
});
Trait Implementations
sourceimpl<R: Clone> Clone for DebugAbbrev<R>
impl<R: Clone> Clone for DebugAbbrev<R>
sourcefn clone(&self) -> DebugAbbrev<R>
fn clone(&self) -> DebugAbbrev<R>
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl<R: Debug> Debug for DebugAbbrev<R>
impl<R: Debug> Debug for DebugAbbrev<R>
sourceimpl<R: Default> Default for DebugAbbrev<R>
impl<R: Default> Default for DebugAbbrev<R>
sourcefn default() -> DebugAbbrev<R>
fn default() -> DebugAbbrev<R>
Returns the “default value” for a type. Read more
sourceimpl<R> From<R> for DebugAbbrev<R>
impl<R> From<R> for DebugAbbrev<R>
sourceimpl<R> Section<R> for DebugAbbrev<R>
impl<R> Section<R> for DebugAbbrev<R>
sourcefn section_name() -> &'static str
fn section_name() -> &'static str
Returns the ELF section name for this type.
sourcefn dwo_section_name() -> Option<&'static str>
fn dwo_section_name() -> Option<&'static str>
Returns the ELF section name (if any) for this type when used in a dwo file. Read more
sourcefn load<F, E>(f: F) -> Result<Self, E> where
F: FnOnce(SectionId) -> Result<R, E>,
fn load<F, E>(f: F) -> Result<Self, E> where
F: FnOnce(SectionId) -> Result<R, E>,
Try to load the section using the given loader function.
sourcefn dwp_range(&self, offset: u32, size: u32) -> Result<Self> where
R: Reader,
fn dwp_range(&self, offset: u32, size: u32) -> Result<Self> where
R: Reader,
Returns the subrange of the section that is the contribution of
a unit in a .dwp
file. Read more
sourcefn lookup_offset_id(&self, id: ReaderOffsetId) -> Option<(SectionId, R::Offset)> where
R: Reader,
fn lookup_offset_id(&self, id: ReaderOffsetId) -> Option<(SectionId, R::Offset)> where
R: Reader,
Returns the Reader
for this section.
impl<R: Copy> Copy for DebugAbbrev<R>
Auto Trait Implementations
impl<R> RefUnwindSafe for DebugAbbrev<R> where
R: RefUnwindSafe,
impl<R> Send for DebugAbbrev<R> where
R: Send,
impl<R> Sync for DebugAbbrev<R> where
R: Sync,
impl<R> Unpin for DebugAbbrev<R> where
R: Unpin,
impl<R> UnwindSafe for DebugAbbrev<R> where
R: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more