Struct gimli::read::DebugAranges
source · [−]pub struct DebugAranges<R> { /* private fields */ }
Expand description
The DebugAranges
struct represents the DWARF address range information
found in the .debug_aranges
section.
Implementations
sourceimpl<'input, Endian> DebugAranges<EndianSlice<'input, Endian>> where
Endian: Endianity,
impl<'input, Endian> DebugAranges<EndianSlice<'input, Endian>> where
Endian: Endianity,
sourcepub fn new(section: &'input [u8], endian: Endian) -> Self
pub fn new(section: &'input [u8], endian: Endian) -> Self
Construct a new DebugAranges
instance from the data in the .debug_aranges
section.
It is the caller’s responsibility to read the .debug_aranges
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::{DebugAranges, LittleEndian};
let debug_aranges =
DebugAranges::new(read_debug_aranges_section(), LittleEndian);
sourceimpl<R: Reader> DebugAranges<R>
impl<R: Reader> DebugAranges<R>
sourcepub fn headers(&self) -> ArangeHeaderIter<R>
pub fn headers(&self) -> ArangeHeaderIter<R>
Iterate the sets of entries in the .debug_aranges
section.
Each set of entries belongs to a single unit.
sourcepub fn header(
&self,
offset: DebugArangesOffset<R::Offset>
) -> Result<ArangeHeader<R>>
pub fn header(
&self,
offset: DebugArangesOffset<R::Offset>
) -> Result<ArangeHeader<R>>
Get the header at the given offset.
sourceimpl<T> DebugAranges<T>
impl<T> DebugAranges<T>
sourcepub fn borrow<'a, F, R>(&'a self, borrow: F) -> DebugAranges<R> where
F: FnMut(&'a T) -> R,
pub fn borrow<'a, F, R>(&'a self, borrow: F) -> DebugAranges<R> where
F: FnMut(&'a T) -> R,
Create a DebugAranges
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::DebugAranges<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 DebugAranges<R>
impl<R: Clone> Clone for DebugAranges<R>
sourcefn clone(&self) -> DebugAranges<R>
fn clone(&self) -> DebugAranges<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 DebugAranges<R>
impl<R: Debug> Debug for DebugAranges<R>
sourceimpl<R: Default> Default for DebugAranges<R>
impl<R: Default> Default for DebugAranges<R>
sourcefn default() -> DebugAranges<R>
fn default() -> DebugAranges<R>
Returns the “default value” for a type. Read more
sourceimpl<R> From<R> for DebugAranges<R>
impl<R> From<R> for DebugAranges<R>
sourceimpl<R> Section<R> for DebugAranges<R>
impl<R> Section<R> for DebugAranges<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 DebugAranges<R>
Auto Trait Implementations
impl<R> RefUnwindSafe for DebugAranges<R> where
R: RefUnwindSafe,
impl<R> Send for DebugAranges<R> where
R: Send,
impl<R> Sync for DebugAranges<R> where
R: Sync,
impl<R> Unpin for DebugAranges<R> where
R: Unpin,
impl<R> UnwindSafe for DebugAranges<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