Struct SyntheticModule 

pub struct SyntheticModule<Arch: RelocationArch = NativeArch, D = (), R = ()> { /* private fields */ }

A Module backed by a synthetic table of absolute symbols.

The module owns stable synthetic ELF symbols, so it can be retained in a ModuleScope without borrowing callback-owned symbol metadata.

Implementations

impl<Arch: RelocationArch> SyntheticModule<Arch>

pub fn new<I>(name: impl Into<String>, symbols: I) -> Self

where I: IntoIterator<Item = SyntheticSymbol>,

Creates a module from an ordered list of synthetic symbols.

pub fn empty(name: impl Into<String>) -> Self

Creates an empty synthetic module.

impl<Arch: RelocationArch, D, R> SyntheticModule<Arch, D, R>

pub fn with_user_data<NewD>( self, user_data: NewD, ) -> SyntheticModule<Arch, NewD, R>

Replaces the user data associated with this synthetic module.

pub const fn user_data(&self) -> &D

Returns immutable user data for this synthetic module.

pub fn user_data_mut(&mut self) -> &mut D

Returns mutable user data for this synthetic module.

pub fn with_memory<M>(self, memory: M) -> Self

where M: ImageMemory + 'static,

Uses a real image-memory backend for this synthetic module.

This is required when synthetic symbols may be used as byte sources, such as for COPY relocations against synthetic object symbols.

pub fn with_tls(self, tls: ModuleTls) -> Self

Sets TLS metadata exposed by this synthetic module.

pub fn with_resolve_hook<F>(self, hook: F) -> SyntheticModule<Arch, D, F>

where F: Fn(&ElfSymbol<Arch::Layout>, VmAddr) -> Result<()> + Send + Sync,

Runs a callback when a synthetic symbol is resolved.

The callback receives the symbol’s stable address and may prepare lazy runtime state before that address is returned.

pub fn with_domain(self, domain: DomainId) -> Self

Binds this synthetic module to one runtime domain.

pub fn insert(&mut self, symbol: SyntheticSymbol) -> Option<SyntheticSymbol>

Inserts one symbol, returning the definition it replaced.

pub fn contains(&self, name: &str) -> bool

Returns whether this module exports a synthetic symbol with name.

pub fn len(&self) -> usize

Returns the number of synthetic symbols.

pub fn is_empty(&self) -> bool

Returns whether this module contains no symbols.

Trait Implementations

impl<Arch: RelocationArch, D: Clone, R: Clone> Clone for SyntheticModule<Arch, D, R>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<Arch, D, R, Tls> From<SyntheticModule<Arch, D, R>> for ModuleHandle<Arch, Tls>

where Arch: RelocationArch, D: Send + Sync + 'static, R: ResolveHook<Arch> + 'static, Tls: TlsResolver<Arch> + 'static,

fn from(module: SyntheticModule<Arch, D, R>) -> Self

Converts to this type from the input type.

impl<Arch, D, R, Tls> Module<Arch, Tls> for SyntheticModule<Arch, D, R>

where Arch: RelocationArch, D: Send + Sync + 'static, R: ResolveHook<Arch> + 'static, Tls: TlsResolver<Arch> + 'static,

fn name(&self) -> &str

Returns the module name used for diagnostics.

fn exports(&self) -> &dyn SymbolExports<Arch::Layout>

Returns the runtime symbol exports for this module.

fn memory(&self) -> &dyn ImageMemory

Returns this module’s runtime memory view.

fn resolve_symbol(&self, symbol: &ElfSymbol<Arch::Layout>) -> Result<VmAddr>

Resolves one of this module’s exported symbols to its runtime address.

fn tls(&self) -> Option<ModuleTls>

Returns TLS metadata when this module owns a TLS block.

fn state(&self) -> &ModuleState

Returns the canonical identity, domain, and lifecycle state for this module.

fn search(&self) -> Option<&ModuleSearch>

Returns metadata used when this module initiates another load.

fn initialize(&self) -> Result<()>

Performs this module’s initialization hook.

fn finalize(&self) -> Result<()>

Performs this module’s finalization hook.

impl<Arch, D, R> SymbolExports<<Arch as RelocationArch>::Layout> for SyntheticModule<Arch, D, R>

where Arch: RelocationArch, D: Send + Sync, R: Send + Sync,

fn for_each(&self, visitor: &mut dyn FnMut(&ElfSymbol<Arch::Layout>))

Visits symbols that can participate in exported-symbol lookup.

fn symbol_name<'exports>( &'exports self, symbol: &ElfSymbol<Arch::Layout>, ) -> Option<&'exports str>

Returns the name for a symbol entry from this export table.

fn lookup<'exports>( &'exports self, lookup: &mut SymbolLookup<'_>, ) -> Option<&'exports ElfSymbol<Arch::Layout>>

Looks up one exported symbol by name and optional version.