Struct object::read::elf::ElfSection

pub struct ElfSection<'data, 'file, Elf, R = &'data [u8]>
where
    Elf: FileHeader,
    R: ReadRef<'data>,
{
    pub(super) file: &'file ElfFile<'data, Elf, R>,
    pub(super) index: SectionIndex,
    pub(super) section: &'data Elf::SectionHeader,
}

A section in an ElfFile.

Most functionality is provided by the ObjectSection trait implementation.

Fields

file: &'file ElfFile<'data, Elf, R>

index: SectionIndex

section: &'data Elf::SectionHeader

Implementations

impl<'data, 'file, Elf: FileHeader, R: ReadRef<'data>> ElfSection<'data, 'file, Elf, R>

pub fn elf_file(&self) -> &'file ElfFile<'data, Elf, R>

Get the ELF file containing this section.

pub fn elf_section_header(&self) -> &'data Elf::SectionHeader

Get the raw ELF section header.

pub fn elf_relocation_section_index(&self) -> Result<Option<SectionIndex>>

Get the index of the relocation section that references this section.

Returns None if there are no relocations. Returns an error if there are multiple relocation sections that reference this section.

pub fn elf_relocation_section( &self, ) -> Result<Option<&'data Elf::SectionHeader>>

Get the relocation section that references this section.

Returns None if there are no relocations. Returns an error if there are multiple relocation sections that reference this section.

pub fn elf_linked_rel(&self) -> Result<&'data [Elf::Rel]>

Get the Elf::Rel entries that apply to this section.

Returns an empty slice if there are no relocations. Returns an error if there are multiple relocation sections that reference this section.

pub fn elf_linked_rela(&self) -> Result<&'data [Elf::Rela]>

Get the Elf::Rela entries that apply to this section.

Returns an empty slice if there are no relocations. Returns an error if there are multiple relocation sections that reference this section.

fn bytes(&self) -> Result<&'data [u8]>

fn maybe_compressed(&self) -> Result<Option<CompressedFileRange>>

fn maybe_compressed_gnu(&self) -> Result<Option<CompressedFileRange>>

Trait Implementations

impl<'data, 'file, Elf, R> Debug for ElfSection<'data, 'file, Elf, R>

where Elf: FileHeader + Debug, R: ReadRef<'data> + Debug, Elf::SectionHeader: Debug,

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

Formats the value using the given formatter.

impl<'data, 'file, Elf, R> ObjectSection<'data> for ElfSection<'data, 'file, Elf, R>

where Elf: FileHeader, R: ReadRef<'data>,

type RelocationIterator = ElfSectionRelocationIterator<'data, 'file, Elf, R>

An iterator for the relocations for a section.

fn index(&self) -> SectionIndex

Returns the section index.

fn address(&self) -> u64

Returns the address of the section.

fn size(&self) -> u64

Returns the size of the section in memory.

fn align(&self) -> u64

Returns the alignment of the section in memory.

fn file_range(&self) -> Option<(u64, u64)>

Returns offset and size of on-disk segment (if any).

fn data(&self) -> Result<&'data [u8]>

Returns the raw contents of the section.

fn data_range(&self, address: u64, size: u64) -> Result<Option<&'data [u8]>>

Return the raw contents of the section data in the given range.

fn compressed_file_range(&self) -> Result<CompressedFileRange>

Returns the potentially compressed file range of the section, along with information about the compression.

fn compressed_data(&self) -> Result<CompressedData<'data>>

Returns the potentially compressed contents of the section, along with information about the compression.

fn name_bytes(&self) -> Result<&'data [u8]>

Returns the name of the section.

fn name(&self) -> Result<&'data str>

Returns the name of the section.

fn segment_name_bytes(&self) -> Result<Option<&[u8]>>

Returns the name of the segment for this section.

fn segment_name(&self) -> Result<Option<&str>>

Returns the name of the segment for this section.

fn kind(&self) -> SectionKind

Return the kind of this section.

fn relocations(&self) -> ElfSectionRelocationIterator<'data, 'file, Elf, R>

Get the relocations for this section.

fn relocation_map(&self) -> Result<RelocationMap>

Construct a relocation map for this section.

fn flags(&self) -> SectionFlags

Section flags that are specific to each file format.

fn uncompressed_data(&self) -> Result<Cow<'data, [u8]>>

Returns the uncompressed contents of the section.

impl<'data, 'file, Elf, R> Sealed for ElfSection<'data, 'file, Elf, R>

where Elf: FileHeader, R: ReadRef<'data>,