Struct ElfBinary

pub struct ElfBinary<'s> {
    pub file: ElfFile<'s>,
    pub dynamic: Option<DynamicInfo>,
}

Abstract representation of a loadable ELF binary.

Fields

file: ElfFile<'s>

The ELF file in question.

dynamic: Option<DynamicInfo>

Parsed information from the .dynamic section (if the binary has it).

Implementations

impl<'s> ElfBinary<'s>

pub fn new(region: &'s [u8]) -> Result<ElfBinary<'s>, ElfLoaderErr>

Create a new ElfBinary.

pub fn is_pie(&self) -> bool

Returns true if the binary is compiled as position independent code or false otherwise.

For the binary to be PIE it needs to have a .dynamic section with PIE set in the flags1 field.

pub fn interpreter(&'s self) -> Option<&'s str>

Returns the dynamic loader if present.

readelf -x .interp

For a statically compiled binary this will return None

pub fn get_arch(&self) -> Machine

Returns the target architecture

pub fn entry_point(&self) -> u64

Return the entry point of the ELF file.

Note this may be zero in case of position independent executables.

pub fn program_headers(&self) -> ProgramIter<'_, '_>

Create a slice of the program headers.

pub fn symbol_name(&self, symbol: &'s dyn Entry) -> &'s str

Get the name of the sectione

pub fn for_each_symbol<F: FnMut(&'s dyn Entry)>( &self, func: F, ) -> Result<(), ElfLoaderErr>

Enumerate all the symbols in the file

pub fn load(&self, loader: &mut dyn ElfLoader) -> Result<(), ElfLoaderErr>

Processing the program headers and issue commands to loader.

Will tell loader to create space in the address space / region where the header is supposed to go, then copy it there, and finally relocate it.

Trait Implementations

impl<'s> Debug for ElfBinary<'s>

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

Formats the value using the given formatter.