elf_loader 0.17.0

A no_std-friendly ELF loader and runtime linker for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

//! Relocation configuration, symbol scopes, and binding policy.
//!
//! Raw images returned by [`crate::Loader`] become executable through the relocation
//! pipeline. In practice, most users configure that pipeline with [`Relocator`],
//! pass the raw image to [`Relocator::run`], then call `relocate()`.
//!
//! This module exposes the main customization points used during relocation:
//!
//! - [`crate::image::SyntheticModule`] for providing external symbol addresses
//! - [`crate::observer::RelocationObserver`] for relocation, lifecycle, and
//!   runtime binding hooks
//! - [`RelocationEvent`] for inspecting the current relocation and search scope
//! - binding policy and lazy-fixup support configured through `Relocator`

mod defs;
mod dynamic;
mod helper;
mod relocator;
mod run;
mod symbol;
mod traits;

pub(crate) use defs::{RelocValue, RelocationValueFormula, RelocationValueKind};
pub(crate) use dynamic::DynamicRelocation;
pub use dynamic::{relocate_relative, relocate_relr};
pub(crate) use helper::{BindingDeps, RelocHelper};
pub(crate) use symbol::{BindingEffect, SymDef, SymbolRegistry, SymbolResolver};
pub use traits::{ObjectArch, RelocationArch};
pub(crate) use traits::{Relocatable, RelocateArgs, RelocationValueInput, RelocationValueProvider};

pub use crate::observer::RelocationEvent;
pub use defs::HandleResult;
pub use relocator::Relocator;
pub use run::RelocatorRun;
pub use traits::{BindingMode, LookupOrder};