Struct object::read::elf::symbol::SymbolTable

pub struct SymbolTable<'data, Elf: FileHeader, R = &'data [u8]>
where
    R: ReadRef<'data>,
{
    section: SectionIndex,
    string_section: SectionIndex,
    shndx_section: SectionIndex,
    symbols: &'data [Elf::Sym],
    strings: StringTable<'data, R>,
    shndx: &'data [U32<Elf::Endian>],
}

A table of symbol entries in an ELF file.

Also includes the string table used for the symbol names.

Returned by SectionTable::symbols.

Fields

section: SectionIndex

string_section: SectionIndex

shndx_section: SectionIndex

symbols: &'data [Elf::Sym]

strings: StringTable<'data, R>

shndx: &'data [U32<Elf::Endian>]

Implementations

impl<'data, Elf: FileHeader, R: ReadRef<'data>> SymbolTable<'data, Elf, R>

pub fn parse( endian: Elf::Endian, data: R, sections: &SectionTable<'data, Elf, R>, section_index: SectionIndex, section: &Elf::SectionHeader, ) -> Result<SymbolTable<'data, Elf, R>>

Parse the given symbol table section.

pub fn section(&self) -> SectionIndex

Return the section index of this symbol table.

pub fn shndx_section(&self) -> SectionIndex

Return the section index of the shndx table.

pub fn string_section(&self) -> SectionIndex

Return the section index of the linked string table.

pub fn strings(&self) -> StringTable<'data, R>

Return the string table used for the symbol names.

pub fn symbols(&self) -> &'data [Elf::Sym]

Return the symbol table.

pub fn iter(&self) -> Iter<'data, Elf::Sym>

Iterate over the symbols.

This includes the null symbol at index 0, which you will usually need to skip.

pub fn enumerate(&self) -> impl Iterator<Item = (SymbolIndex, &'data Elf::Sym)>

Iterate over the symbols and their indices.

This includes the null symbol at index 0, which you will usually need to skip.

pub fn is_empty(&self) -> bool

Return true if the symbol table is empty.

pub fn len(&self) -> usize

The number of symbols.

pub fn symbol(&self, index: SymbolIndex) -> Result<&'data Elf::Sym>

Get the symbol at the given index.

Returns an error for null entry at index 0.

pub fn shndx(&self, endian: Elf::Endian, index: SymbolIndex) -> Option<u32>

Return the extended section index for the given symbol if present.

pub fn symbol_section( &self, endian: Elf::Endian, symbol: &Elf::Sym, index: SymbolIndex, ) -> Result<Option<SectionIndex>>

Return the section index for the given symbol.

This uses the extended section index if present.

pub fn symbol_name( &self, endian: Elf::Endian, symbol: &Elf::Sym, ) -> Result<&'data [u8]>

Return the symbol name for the given symbol.

pub fn map<Entry: SymbolMapEntry, F: Fn(&'data Elf::Sym) -> Option<Entry>>( &self, endian: Elf::Endian, f: F, ) -> SymbolMap<Entry>

Construct a map from addresses to a user-defined map entry.

Trait Implementations

impl<'data, Elf: Clone + FileHeader, R> Clone for SymbolTable<'data, Elf, R>

where R: ReadRef<'data> + Clone, Elf::Sym: Clone, Elf::Endian: Clone,

fn clone(&self) -> SymbolTable<'data, Elf, R>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'data, Elf: Debug + FileHeader, R> Debug for SymbolTable<'data, Elf, R>

where R: ReadRef<'data> + Debug, Elf::Sym: Debug, Elf::Endian: Debug,

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

Formats the value using the given formatter.

impl<'data, Elf: FileHeader, R: ReadRef<'data>> Default for SymbolTable<'data, Elf, R>

fn default() -> Self

Returns the “default value” for a type.

impl<'data, Elf: Copy + FileHeader, R> Copy for SymbolTable<'data, Elf, R>

where R: ReadRef<'data> + Copy, Elf::Sym: Copy, Elf::Endian: Copy,