Struct RelocatorRun 

pub struct RelocatorRun<'cfg, T, Arch: RelocationArch = NativeArch, Obs = (), Tls: TlsResolver<Arch> = (), Binder = ()> { /* private fields */ }

Per-image relocation run state.

A run owns the raw image being relocated and the scope being assembled for that image. It consumes itself when relocate is called.

Implementations

impl<'cfg, T, Arch, Obs, Tls, Binder> RelocatorRun<'cfg, T, Arch, Obs, Tls, Binder>

where Arch: RelocationArch, Tls: TlsResolver<Arch>, Binder: LazyBinder<Arch>,

pub fn observer<NewObs>( self, observer: NewObs, ) -> RelocatorRun<'cfg, T, Arch, NewObs, Tls, Binder>

where NewObs: RelocationObserver<Arch>,

Sets the runtime-linker observer used during relocation.

pub fn binding(self, binding: BindingMode) -> Self

Overrides the relocation binding mode.

pub fn lookup_order(self, order: LookupOrder) -> Self

Sets precedence between the local and context-global lookup scopes.

pub fn global_scope(self, global: &GlobalScope<Arch, Tls>) -> Self

Uses a LinkContext global symbol scope.

The shared handle is retained only for the relocation run. Deferred binding stores a weak reference and therefore does not keep the context or unrelated global modules alive.

pub fn modules<I, R>(self, modules: I) -> Self

where I: IntoIterator<Item = R>, R: Into<ModuleHandle<Arch, Tls>>,

Uses the same ordered modules for eager and deferred symbol lookup.

pub fn local_scope(self, scope: LocalScope<Arch, Tls>) -> Self

Replaces the complete eager and deferred symbol lookup scope.

impl<'cfg, T, Arch, Obs, Tls, Binder> RelocatorRun<'cfg, T, Arch, Obs, Tls, Binder>

where T: SupportLazy, Arch: RelocationArch, Tls: TlsResolver<Arch>, Binder: LazyBinder<Arch>,

pub fn eager(self) -> Self

Forces eager binding.

pub fn lazy(self) -> Self

Forces lazy binding.

impl<'cfg, T, Arch, Obs, Tls, Binder> RelocatorRun<'cfg, T, Arch, Obs, Tls, Binder>

where Arch: RelocationArch, Tls: TlsResolver<Arch>, Obs: RelocationObserver<Arch>, Binder: LazyBinder<Arch>,

pub fn relocate<D>(self) -> Result<<T as Relocatable<D>>::Output>

where D: Send + Sync + 'static, T: Relocatable<D, Arch = Arch, Tls = Tls>,

Executes relocation with the current run state.

Trait Implementations

impl<'cfg, T, Arch, Obs, Tls, Binder> Clone for RelocatorRun<'cfg, T, Arch, Obs, Tls, Binder>

where Arch: RelocationArch, Tls: TlsResolver<Arch>, T: Clone, Obs: Clone,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.