Struct ElfLinker 

pub struct ElfLinker { /* private fields */ }

Loader which links together multiple Elf files.

Can do some rudimentary linking of binaries.

Implementations

impl ElfLinker

pub fn new( filename: PathBuf, do_relocations: bool, just_interpreter: bool, ld_paths: Option<Vec<PathBuf>>, ) -> Result<ElfLinker, Error>

Create a new ElfLinker.

It is recommended you use ElfLinkerBuilder to build an ElfLinker.

pub fn loaded(&self) -> &BTreeMap<String, Elf>

Get the ELFs loaded and linked in this loader

pub fn filename(&self) -> &Path

Get the filename of the ELF we’re loading

pub fn load_elf( &mut self, filename: &Path, base_address: u64, ) -> Result<(), Error>

Takes the path to an Elf, and a base address the Elf should be loaded at. Loads the Elf, all it’s dependencies (DT_NEEDED), and then handles the supported relocations.

pub fn get_elf(&self) -> Result<&Elf, Error>

Get the Elf for the primary elf loaded.

pub fn get_interpreter(&self) -> Result<Option<&Elf>, Error>

If the primary Elf we’re loading has an interpreter designated in its dynamic sectino, get the Elf for the interpreter.

pub fn add_user_function(&mut self, address: u64)

Inform the linker of a function at the given address.

This function will be added to calls to function_entries and will be automatically lifted when calling to_program.

Trait Implementations

impl Debug for ElfLinker

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

Formats the value using the given formatter.

impl Loader for ElfLinker

fn memory(&self) -> Result<Memory, Error>

Get a model of the memory contained in the binary

fn function_entries(&self) -> Result<Vec<FunctionEntry>, Error>

Get addresses for known function entries

fn program_entry(&self) -> u64

The address program execution should begin at

fn architecture(&self) -> &dyn Architecture

Get the architecture of the binary

fn as_any(&self) -> &dyn Any

Cast loader to Any

fn symbols(&self) -> Vec<Symbol>

Get the symbols for this loader

fn function(&self, address: u64) -> Result<Function, Error>

Lift just one function from the executable

fn function_extended( &self, address: u64, options: &Options, ) -> Result<Function, Error>

Lift just one function from the executable, while also supplying translator options.

fn symbols_map(&self) -> HashMap<u64, Symbol>

Get the symbols as a hashmap by address

fn program(&self) -> Result<Program, Error>

Lift executable into an il::Program.

fn program_verbose( &self, options: &Options, ) -> Result<(Program, Vec<(FunctionEntry, Error)>), Error>

Lift executable into an il::Program.

fn program_recursive(&self) -> Result<Program, Error>

Lift executable into an il::Program, while recursively resolving branch targets into functions.

fn program_recursive_verbose( &self, options: &Options, ) -> Result<(Program, Vec<(FunctionEntry, Error)>), Error>

Lift executable into an il::Program, while recursively resolving branch targets into functions.