Struct gimli::read::DebugAddr

pub struct DebugAddr<R> { /* private fields */ }

The raw contents of the .debug_addr section.

Implementations

impl<R: Reader> DebugAddr<R>

pub fn get_address(
    &self,
    address_size: u8,
    base: DebugAddrBase<R::Offset>,
    index: DebugAddrIndex<R::Offset>
) -> Result<u64>

Returns the address at the given base and index.

A set of addresses in the .debug_addr section consists of a header followed by a series of addresses.

The base must be the DW_AT_addr_base value from the compilation unit DIE. This is an offset that points to the first address following the header.

The index is the value of a DW_FORM_addrx attribute.

The address_size must be the size of the address for the compilation unit. This value must also match the header. However, note that we do not parse the header to validate this, since locating the header is unreliable, and the GNU extensions do not emit it.

impl<T> DebugAddr<T>

pub fn borrow<'a, F, R>(&'a self, borrow: F) -> DebugAddr<R> where
    F: FnMut(&'a T) -> R, 

Create a DebugAddr 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::DebugAddr<Vec<u8>> = load_section();
// Create a reference to the DWARF section.
let section = owned_section.borrow(|section| {
    gimli::EndianSlice::new(&section, gimli::LittleEndian)
});

Trait Implementations

impl<R: Clone> Clone for DebugAddr<R>

fn clone(&self) -> DebugAddr<R>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R: Debug> Debug for DebugAddr<R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<R: Default> Default for DebugAddr<R>

fn default() -> DebugAddr<R>

Returns the “default value” for a type.

impl<R> From<R> for DebugAddr<R>

fn from(section: R) -> Self

Performs the conversion.

impl<R> Section<R> for DebugAddr<R>

fn id() -> SectionId

Returns the section id for this type.

fn reader(&self) -> &R

Returns the Reader for this section.

fn section_name() -> &'static str

Returns the ELF section name for this type.

fn dwo_section_name() -> Option<&'static str>

Returns the ELF section name (if any) for this type when used in a dwo file.

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.

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.

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 DebugAddr<R>