Type Alias object::read::elf::file::ElfFile32

pub type ElfFile32<'data, Endian = Endianness, R = &'data [u8]> = ElfFile<'data, FileHeader32<Endian>, R>;

A 32-bit ELF object file.

This is a file that starts with elf::FileHeader32, and corresponds to crate::FileKind::Elf32.

Aliased Type

struct ElfFile32<'data, Endian = Endianness, R = &'data [u8]> {
    pub(super) endian: <FileHeader32<Endian> as FileHeader>::Endian,
    pub(super) data: R,
    pub(super) header: &'data FileHeader32<Endian>,
    pub(super) segments: &'data [<FileHeader32<Endian> as FileHeader>::ProgramHeader],
    pub(super) sections: SectionTable<'data, FileHeader32<Endian>, R>,
    pub(super) relocations: RelocationSections,
    pub(super) symbols: SymbolTable<'data, FileHeader32<Endian>, R>,
    pub(super) dynamic_symbols: SymbolTable<'data, FileHeader32<Endian>, R>,
}

Fields

endian: <FileHeader32<Endian> as FileHeader>::Endian

data: R

header: &'data FileHeader32<Endian>

segments: &'data [<FileHeader32<Endian> as FileHeader>::ProgramHeader]

sections: SectionTable<'data, FileHeader32<Endian>, R>

relocations: RelocationSections

symbols: SymbolTable<'data, FileHeader32<Endian>, R>

dynamic_symbols: SymbolTable<'data, FileHeader32<Endian>, R>

Implementations

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

pub fn parse(data: R) -> Result<Self>

Parse the raw ELF file data.

pub fn endian(&self) -> Elf::Endian

Returns the endianness.

pub fn data(&self) -> R

Returns the raw data.

pub fn raw_header(&self) -> &'data Elf

Returns the raw ELF file header.

pub fn raw_segments(&self) -> &'data [Elf::ProgramHeader]

Returns the raw ELF segments.

fn raw_section_by_name<'file>( &'file self, section_name: &[u8] ) -> Option<ElfSection<'data, 'file, Elf, R>>

fn zdebug_section_by_name<'file>( &'file self, _section_name: &[u8] ) -> Option<ElfSection<'data, 'file, Elf, R>>

Trait Implementations

impl<'data, Elf, R> Debug for ElfFile<'data, Elf, R>where Elf: FileHeader + Debug, R: ReadRef<'data> + Debug, Elf::Endian: Debug, Elf::ProgramHeader: Debug,

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

Formats the value using the given formatter.

impl<'data, 'file, Elf, R> Object<'data, 'file> for ElfFile<'data, Elf, R>where Elf: FileHeader, R: 'file + ReadRef<'data>, 'data: 'file,

type Segment = ElfSegment<'data, 'file, Elf, R>

A loadable segment in the object file.

type SegmentIterator = ElfSegmentIterator<'data, 'file, Elf, R>

An iterator for the loadable segments in the object file.

type Section = ElfSection<'data, 'file, Elf, R>

A section in the object file.

type SectionIterator = ElfSectionIterator<'data, 'file, Elf, R>

An iterator for the sections in the object file.

type Comdat = ElfComdat<'data, 'file, Elf, R>

A COMDAT section group in the object file.

type ComdatIterator = ElfComdatIterator<'data, 'file, Elf, R>

An iterator for the COMDAT section groups in the object file.

type Symbol = ElfSymbol<'data, 'file, Elf, R>

A symbol in the object file.

type SymbolIterator = ElfSymbolIterator<'data, 'file, Elf, R>

An iterator for symbols in the object file.

type SymbolTable = ElfSymbolTable<'data, 'file, Elf, R>

A symbol table in the object file.

type DynamicRelocationIterator = ElfDynamicRelocationIterator<'data, 'file, Elf, R>

An iterator for the dynamic relocations in the file.

fn architecture(&self) -> Architecture

Get the architecture type of the file.

fn is_little_endian(&self) -> bool

Return true if the file is little endian, false if it is big endian.

fn is_64(&self) -> bool

Return true if the file can contain 64-bit addresses.

fn kind(&self) -> ObjectKind

Return the kind of this object.

fn segments(&'file self) -> ElfSegmentIterator<'data, 'file, Elf, R>

Get an iterator for the loadable segments in the file.

fn section_by_name_bytes( &'file self, section_name: &[u8] ) -> Option<ElfSection<'data, 'file, Elf, R>>

Like Self::section_by_name, but allows names that are not UTF-8.

fn section_by_index( &'file self, index: SectionIndex ) -> Result<ElfSection<'data, 'file, Elf, R>>

Get the section at the given index.

fn sections(&'file self) -> ElfSectionIterator<'data, 'file, Elf, R>

Get an iterator for the sections in the file.

fn comdats(&'file self) -> ElfComdatIterator<'data, 'file, Elf, R>

Get an iterator for the COMDAT section groups in the file.

fn symbol_by_index( &'file self, index: SymbolIndex ) -> Result<ElfSymbol<'data, 'file, Elf, R>>

Get the debugging symbol at the given index.

fn symbols(&'file self) -> ElfSymbolIterator<'data, 'file, Elf, R>

Get an iterator for the debugging symbols in the file.

fn symbol_table(&'file self) -> Option<ElfSymbolTable<'data, 'file, Elf, R>>

Get the debugging symbol table, if any.

fn dynamic_symbols(&'file self) -> ElfSymbolIterator<'data, 'file, Elf, R>

Get an iterator for the dynamic linking symbols in the file.

fn dynamic_symbol_table( &'file self ) -> Option<ElfSymbolTable<'data, 'file, Elf, R>>

Get the dynamic linking symbol table, if any.

fn dynamic_relocations( &'file self ) -> Option<ElfDynamicRelocationIterator<'data, 'file, Elf, R>>

Get the dynamic relocations for this file.

fn imports(&self) -> Result<Vec<Import<'data>>>

Get the imported symbols.

fn exports(&self) -> Result<Vec<Export<'data>>>

Get the exported symbols that expose both a name and an address.

fn has_debug_symbols(&self) -> bool

Return true if the file contains DWARF debug information sections, false if not.

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

The build ID from an ELF NT_GNU_BUILD_ID note.

fn gnu_debuglink(&self) -> Result<Option<(&'data [u8], u32)>>

The filename and CRC from a .gnu_debuglink section.

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

The filename and build ID from a .gnu_debugaltlink section.

fn relative_address_base(&self) -> u64

Get the base address used for relative virtual addresses.

fn entry(&self) -> u64

Get the virtual address of the entry point of the binary.

fn flags(&self) -> FileFlags

File flags that are specific to each file format.

fn sub_architecture(&self) -> Option<SubArchitecture>

Get the sub-architecture type of the file if known.

fn endianness(&self) -> Endianness

Get the endianness of the file.

fn section_by_name(&'file self, section_name: &str) -> Option<Self::Section>

Get the section named section_name, if such a section exists.

fn symbol_by_name(&'file self, symbol_name: &str) -> Option<Self::Symbol>

Get the symbol named symbol_name, if the symbol exists.

fn symbol_by_name_bytes(&'file self, symbol_name: &[u8]) -> Option<Self::Symbol>

Like Self::symbol_by_name, but allows names that are not UTF-8.

fn symbol_map(&'file self) -> SymbolMap<SymbolMapName<'data>>

Construct a map from addresses to symbol names.

fn object_map(&'file self) -> ObjectMap<'data>

Construct a map from addresses to symbol names and object file names.

fn mach_uuid(&self) -> Result<Option<[u8; 16]>>

The UUID from a Mach-O LC_UUID load command.

fn pdb_info(&self) -> Result<Option<CodeView<'_>>>

The filename and GUID from the PE CodeView section.

impl<'data, Elf, R> Sealed for ElfFile<'data, Elf, R>where Elf: FileHeader, R: ReadRef<'data>,