Struct object::read::elf::ElfFile

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

A partially parsed ELF file.

Most functionality is provided by the Object trait implementation.

Implementations§

source§

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

source

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

Parse the raw ELF file data.

source

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

Returns the endianness.

source

pub fn data(&self) -> R

Returns the raw data.

source

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

👎Deprecated: Use elf_header instead

Returns the raw ELF file header.

source

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

👎Deprecated: Use elf_program_headers instead

Returns the raw ELF segments.

source

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

Get the raw ELF file header.

source

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

Get the raw ELF program headers.

Returns an empty slice if the file has no program headers.

source

pub fn elf_section_table(&self) -> &SectionTable<'data, Elf, R>

Get the ELF section table.

Returns an empty section table if the file has no section headers.

source

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

Get the ELF symbol table.

Returns an empty symbol table if the file has no symbol table.

source

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

Get the ELF dynamic symbol table.

Returns an empty symbol table if the file has no dynamic symbol table.

source

pub fn elf_relocation_sections(&self) -> &RelocationSections

Get a mapping for linked relocation sections.

Trait Implementations§

source§

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

source§

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

Formats the value using the given formatter. Read more
source§

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

§

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

A loadable segment in the object file.
§

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

An iterator for the loadable segments in the object file.
§

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

A section in the object file.
§

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

An iterator for the sections in the object file.
§

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

A COMDAT section group in the object file.
§

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

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

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

A symbol in the object file.
§

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

An iterator for symbols in the object file.
§

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

A symbol table in the object file.
§

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

An iterator for the dynamic relocations in the file. Read more
source§

fn architecture(&self) -> Architecture

Get the architecture type of the file.
source§

fn is_little_endian(&self) -> bool

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

fn is_64(&self) -> bool

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

fn kind(&self) -> ObjectKind

Return the kind of this object.
source§

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

Get an iterator for the loadable segments in the file. Read more
source§

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

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

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

Get the section at the given index. Read more
source§

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

Get an iterator for the sections in the file.
source§

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

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

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

Get the debugging symbol at the given index. Read more
source§

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

Get an iterator for the debugging symbols in the file. Read more
source§

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

Get the debugging symbol table, if any.
source§

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

Get an iterator for the dynamic linking symbols in the file. Read more
source§

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

Get the dynamic linking symbol table, if any. Read more
source§

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

Get the dynamic relocations for this file. Read more
source§

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

Get the imported symbols.
source§

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

Get the exported symbols that expose both a name and an address. Read more
source§

fn has_debug_symbols(&self) -> bool

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

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

The build ID from an ELF NT_GNU_BUILD_ID note.
The filename and CRC from a .gnu_debuglink section.
The filename and build ID from a .gnu_debugaltlink section.
source§

fn relative_address_base(&self) -> u64

Get the base address used for relative virtual addresses. Read more
source§

fn entry(&self) -> u64

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

fn flags(&self) -> FileFlags

File flags that are specific to each file format.
source§

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

Get the sub-architecture type of the file if known. Read more
source§

fn endianness(&self) -> Endianness

Get the endianness of the file.
source§

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

Get the section named section_name, if such a section exists. Read more
source§

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

Get the symbol named symbol_name, if the symbol exists.
source§

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

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

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

Construct a map from addresses to symbol names. Read more
source§

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

Construct a map from addresses to symbol names and object file names. Read more
source§

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

The UUID from a Mach-O LC_UUID load command.
source§

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

The filename and GUID from the PE CodeView section.

Auto Trait Implementations§

§

impl<'data, Elf, R> Freeze for ElfFile<'data, Elf, R>
where <Elf as FileHeader>::Endian: Freeze, R: Freeze,

§

impl<'data, Elf, R> RefUnwindSafe for ElfFile<'data, Elf, R>

§

impl<'data, Elf, R> Send for ElfFile<'data, Elf, R>
where <Elf as FileHeader>::Endian: Send + Sync, R: Send, Elf: Sync, <Elf as FileHeader>::ProgramHeader: Sync, <Elf as FileHeader>::SectionHeader: Sync, <Elf as FileHeader>::Sym: Sync,

§

impl<'data, Elf, R> Sync for ElfFile<'data, Elf, R>
where <Elf as FileHeader>::Endian: Sync, R: Sync, Elf: Sync, <Elf as FileHeader>::ProgramHeader: Sync, <Elf as FileHeader>::SectionHeader: Sync, <Elf as FileHeader>::Sym: Sync,

§

impl<'data, Elf, R> Unpin for ElfFile<'data, Elf, R>
where <Elf as FileHeader>::Endian: Unpin, R: Unpin,

§

impl<'data, Elf, R> UnwindSafe for ElfFile<'data, Elf, R>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.