Struct DebugNames 

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

The DebugNames struct represents the DWARF 5 name index information found in the .debug_names section.

The .debug_names section provides an index for efficiently finding debugging information entries (DIEs) by name. It contains hash tables that map names to DIE offsets, allowing debuggers to quickly locate functions, variables, types, and other named entities.

Implementations

impl<'input, Endian> DebugNames<EndianSlice<'input, Endian>>

where Endian: Endianity,

pub fn new(debug_names_section: &'input [u8], endian: Endian) -> Self

Construct a new DebugNames instance from the data in the .debug_names section.

It is the caller’s responsibility to read the .debug_names section and present it as a &[u8] slice. That means using some ELF loader on Linux, a Mach-O loader on macOS, etc.

use gimli::{DebugNames, LittleEndian};

let debug_names =
    DebugNames::new(read_debug_names_section_somehow(), LittleEndian);

impl<T> DebugNames<T>

pub fn borrow<'a, F, R>(&'a self, borrow: F) -> DebugNames<R>

where F: FnMut(&'a T) -> R,

Create a DebugNames section that references the data in self.

This is useful when R implements Reader but T does not.

Used by DwarfSections::borrow.

impl<R: Reader> DebugNames<R>

pub fn headers(&self) -> NameIndexHeaderIter<R>

Iterate over all name indexes in the .debug_names section.

Trait Implementations

impl<R: Clone> Clone for DebugNames<R>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R: Debug> Debug for DebugNames<R>

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

Formats the value using the given formatter.

impl<R: Default> Default for DebugNames<R>

fn default() -> DebugNames<R>

Returns the “default value” for a type.

impl<R> From<R> for DebugNames<R>

fn from(debug_names_section: R) -> Self

Converts to this type from the input type.

impl<R> Section<R> for DebugNames<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 xcoff_section_name() -> Option<&'static str>

Returns the XCOFF section name (if any) for this type when used in a XCOFF 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 DebugNames<R>