Struct falcon::loader::ElfLinker

pub struct ElfLinker { /* fields omitted */ }

Loader which links together multiple Elf files.

Can do some rudimentary linking of binaries.

Methods

impl ElfLinker

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

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<()>

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>

Get the Elf for the primary elf loaded.

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

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>

Get a model of the memory contained in the binary

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

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>

Lift just one function from the executable

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

Get the symbols as a hashmap by address

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

Lift executable into an il::Program.

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

Lift executable into an il::Program.

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

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

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

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