Struct object::read::elf::SectionTable

pub struct SectionTable<'data, Elf: FileHeader, R = &'data [u8]> where
    R: ReadRef<'data>,  { /* private fields */ }

The table of section headers in an ELF file.

Also includes the string table used for the section names.

Implementations

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

pub fn new(
    sections: &'data [Elf::SectionHeader],
    strings: StringTable<'data, R>
) -> Self

Create a new section table.

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

Iterate over the section headers.

pub fn is_empty(&self) -> bool

Return true if the section table is empty.

pub fn len(&self) -> usize

The number of section headers.

pub fn section(&self, index: SectionIndex) -> Result<&'data Elf::SectionHeader>

Return the section header at the given index.

pub fn section_by_name(
    &self,
    endian: Elf::Endian,
    name: &[u8]
) -> Option<(usize, &'data Elf::SectionHeader)>

Return the section header with the given name.

Ignores sections with invalid names.

pub fn section_name(
    &self,
    endian: Elf::Endian,
    section: &'data Elf::SectionHeader
) -> Result<&'data [u8]>

Return the section name for the given section header.

pub fn strings(
    &self,
    endian: Elf::Endian,
    data: R,
    index: SectionIndex
) -> Result<StringTable<'data, R>>

Return the string table at the given section index.

Returns an error if the section is not a string table.

pub fn symbols(
    &self,
    endian: Elf::Endian,
    data: R,
    sh_type: u32
) -> Result<SymbolTable<'data, Elf, R>>

Return the symbol table of the given section type.

Returns an empty symbol table if the symbol table does not exist.

pub fn symbol_table_by_index(
    &self,
    endian: Elf::Endian,
    data: R,
    index: SectionIndex
) -> Result<SymbolTable<'data, Elf, R>>

Return the symbol table at the given section index.

Returns an error if the section is not a symbol table.

pub fn relocation_sections(
    &self,
    endian: Elf::Endian,
    symbol_section: SectionIndex
) -> Result<RelocationSections>

Create a mapping from section index to associated relocation sections.

pub fn dynamic(
    &self,
    endian: Elf::Endian,
    data: R
) -> Result<Option<(&'data [Elf::Dyn], SectionIndex)>>

Return the contents of a dynamic section.

Also returns the linked string table index.

Returns Ok(None) if there is no SHT_DYNAMIC section. Returns Err for invalid values.

pub fn hash_header(
    &self,
    endian: Elf::Endian,
    data: R
) -> Result<Option<&'data HashHeader<Elf::Endian>>>

Return the header of a SysV hash section.

Returns Ok(None) if there is no SysV GNU hash section. Returns Err for invalid values.

pub fn hash(
    &self,
    endian: Elf::Endian,
    data: R
) -> Result<Option<(HashTable<'data, Elf>, SectionIndex)>>

Return the contents of a SysV hash section.

Also returns the linked symbol table index.

Returns Ok(None) if there is no SysV hash section. Returns Err for invalid values.

pub fn gnu_hash_header(
    &self,
    endian: Elf::Endian,
    data: R
) -> Result<Option<&'data GnuHashHeader<Elf::Endian>>>

Return the header of a GNU hash section.

Returns Ok(None) if there is no GNU hash section. Returns Err for invalid values.

pub fn gnu_hash(
    &self,
    endian: Elf::Endian,
    data: R
) -> Result<Option<(GnuHashTable<'data, Elf>, SectionIndex)>>

Return the contents of a GNU hash section.

Also returns the linked symbol table index.

Returns Ok(None) if there is no GNU hash section. Returns Err for invalid values.

pub fn gnu_versym(
    &self,
    endian: Elf::Endian,
    data: R
) -> Result<Option<(&'data [Versym<Elf::Endian>], SectionIndex)>>

Return the contents of a SHT_GNU_VERSYM section.

Also returns the linked symbol table index.

Returns Ok(None) if there is no SHT_GNU_VERSYM section. Returns Err for invalid values.

pub fn gnu_verdef(
    &self,
    endian: Elf::Endian,
    data: R
) -> Result<Option<(VerdefIterator<'data, Elf>, SectionIndex)>>

Return the contents of a SHT_GNU_VERDEF section.

Also returns the linked string table index.

Returns Ok(None) if there is no SHT_GNU_VERDEF section. Returns Err for invalid values.

pub fn gnu_verneed(
    &self,
    endian: Elf::Endian,
    data: R
) -> Result<Option<(VerneedIterator<'data, Elf>, SectionIndex)>>

Return the contents of a SHT_GNU_VERNEED section.

Also returns the linked string table index.

Returns Ok(None) if there is no SHT_GNU_VERNEED section. Returns Err for invalid values.

pub fn versions(
    &self,
    endian: Elf::Endian,
    data: R
) -> Result<Option<VersionTable<'data, Elf>>>

Returns the symbol version table.

Returns Ok(None) if there is no SHT_GNU_VERSYM section. Returns Err for invalid values.

Trait Implementations

impl<'data, Elf: Clone + FileHeader, R: Clone> Clone for SectionTable<'data, Elf, R> where
    R: ReadRef<'data>,
    Elf::SectionHeader: Clone, 

fn clone(&self) -> SectionTable<'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> Debug for SectionTable<'data, Elf, R> where
    R: ReadRef<'data>,
    Elf::SectionHeader: Debug, 

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

Formats the value using the given formatter.

impl<'data, Elf: Default + FileHeader, R: Default> Default for SectionTable<'data, Elf, R> where
    R: ReadRef<'data>,
    Elf::SectionHeader: Default, 

fn default() -> SectionTable<'data, Elf, R>

Returns the “default value” for a type.

impl<'data, Elf: Copy + FileHeader, R: Copy> Copy for SectionTable<'data, Elf, R> where
    R: ReadRef<'data>,
    Elf::SectionHeader: Copy,