Struct Elf

pub struct Elf { /* private fields */ }

Represents a parsed ELF (Executable and Linkable Format) file.

The ELF format is a common standard file format for executable files, object code, shared libraries, and core dumps.

Implementations

impl Elf

pub fn load<P: AsRef<Path>>(path: P) -> ParseElfResult<Elf>

Loads an ELF file from disk and parses it

Errors

Returns ‘Err’ if the file can not be loaded or if parsing fails, with a description of the failure

Examples

let elf = Elf::load("examples/example-binary").unwrap();

pub fn parse<R: Read + Seek>(reader: &mut R) -> ParseElfResult<Elf>

Parses an ELF file from a reader source

‘reader’ can be anything that implements both ‘Read’ and ‘Seek’

Errors

Returns ‘Err’ if parsing fails, with a description of what caused the failure

Examples

let mut buf = std::io::BufReader::new(file);
let elf = Elf::parse(&mut buf).unwrap();

pub fn try_get_section(&self, section_name: &str) -> Option<&Section>

Tries to retrieve a section by name, returns ‘None’ if the section does not exist

Examples

 
let elf = Elf::load("examples/example-binary").unwrap();
let text = elf.try_get_section(".text").unwrap();
 
assert_eq!(SectionFlags::AllocExecute, text.header().flags());

pub fn header(&self) -> &ElfHeader

Returns the ELF files header

pub fn sections(&self) -> SectionIter<'_>

Returns an Iterator that iterates over references of sections contained in this Elf file

pub fn segments(&self) -> SegmentIter<'_>

Returns an Iterator that iterates over references of program headers contained in this Elf file

Trait Implementations

impl Debug for Elf

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

Formats the value using the given formatter.