Struct EngineInner 

pub struct EngineInner {
    compiler: Option<Box<dyn Compiler>>,
    features: Features,
    code_memory: Vec<CodeMemory>,
    elf_mapped_binary: Vec<MemoryMappedBinary>,
    signatures: SignatureRegistry,
}

The inner contents of Engine

Fields

compiler: Option<Box<dyn Compiler>>

The compiler and cpu features

features: Features

The compiler and cpu features

code_memory: Vec<CodeMemory>

The code memory is responsible of publishing the compiled functions to memory.

elf_mapped_binary: Vec<MemoryMappedBinary>

Memory-mapped ELF artifact image, produced by --experimental-artifact.

signatures: SignatureRegistry

The signature registry is used mainly to operate with trampolines performantly.

Implementations

impl EngineInner

pub fn compiler(&self) -> Result<&dyn Compiler, CompileError>

Gets the compiler associated to this engine.

pub fn validate(&self, data: &[u8]) -> Result<(), CompileError>

Validate the module

pub fn features(&self) -> &Features

The Wasm features

pub(crate) fn allocate<'a, FunctionBody, CustomSection>( &'a mut self, _module: &ModuleInfo, functions: impl ExactSizeIterator<Item = &'a FunctionBody> + 'a, function_call_trampolines: impl ExactSizeIterator<Item = &'a FunctionBody> + 'a, dynamic_function_trampolines: impl ExactSizeIterator<Item = &'a FunctionBody> + 'a, custom_sections: impl ExactSizeIterator<Item = &'a CustomSection> + Clone + 'a, ) -> Result<(PrimaryMap<LocalFunctionIndex, FunctionExtent>, PrimaryMap<SignatureIndex, VMTrampoline>, PrimaryMap<FunctionIndex, FunctionBodyPtr>, PrimaryMap<SectionIndex, SectionBodyPtr>), CompileError>

where FunctionBody: FunctionBodyLike<'a> + 'a, CustomSection: CustomSectionLike<'a> + 'a,

Allocate compiled functions into memory

pub(crate) fn publish_compiled_code(&mut self)

Make memory containing compiled code executable.

pub(crate) fn publish_eh_frame( &mut self, eh_frame: Option<&[u8]>, ) -> Result<(), CompileError>

Register DWARF-type exception handling information associated with the code.

pub(crate) fn map_elf_binary<'a, R: ReadRef<'a>>( &mut self, object_file: &File<'a, R>, data: &[u8], ) -> Result<*mut c_void, CompileError>

Memory-map a compiled ELF artifact image, keeping the mapping alive for the lifetime of the engine. Returns the base address of the mapping, which section/symbol offsets from the image are relative to.

pub(crate) fn map_elf_binary_file<'a, R: ReadRef<'a>>( &mut self, object_file: &File<'a, R>, file: RawFd, ) -> Result<*mut c_void, CompileError>

Memory-map a compiled ELF artifact directly from a file.

pub(crate) fn publish_elf_eh_frame( &mut self, address: u64, size: u64, ) -> Result<(), CompileError>

Register DWARF-type exception handling information associated with the code.

pub fn signatures(&self) -> &SignatureRegistry

Shared signature registry.

pub(crate) fn register_frame_info( &mut self, frame_info: GlobalFrameInfoRegistration, )

Register the frame info for the code memory

pub(crate) fn register_elf_frame_info( &mut self, frame_info: GlobalFrameInfoRegistration, )

Register the frame info for the most recently mapped ELF binary.

pub(crate) fn register_perfmap( &self, finished_functions: &PrimaryMap<LocalFunctionIndex, FunctionExtent>, module_info: &ModuleInfo, ) -> Result<(), CompileError>

Trait Implementations

impl Debug for EngineInner

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

Formats the value using the given formatter.