Struct UniversalEngine

pub struct UniversalEngine { /* private fields */ }

A WebAssembly Universal Engine.

Implementations

impl UniversalEngine

pub fn new( compiler: Box<dyn Compiler>, target: Target, features: Features, memory_allocator: LimitedMemoryPool, ) -> Self

Create a new UniversalEngine with the given config

pub fn headless(memory_allocator: LimitedMemoryPool) -> Self

Create a headless UniversalEngine

A headless engine is an engine without any compiler attached. This is useful for assuring a minimal runtime for running WebAssembly modules.

For example, for running in IoT devices where compilers are very expensive, or also to optimize startup speed.

Important

Headless engines can’t compile or validate any modules, they just take already processed Modules (via Module::serialize).

pub fn compile_universal( &self, binary: &[u8], tunables: &dyn Tunables, ) -> Result<UniversalExecutable, CompileError>

Compile a WebAssembly binary

pub fn load_universal_executable( &self, executable: &UniversalExecutable, ) -> Result<UniversalArtifact, CompileError>

Load a UniversalExecutable with this engine.

pub fn load_universal_executable_ref( &self, executable: &UniversalExecutableRef<'_>, ) -> Result<UniversalArtifact, CompileError>

Load a UniversalExecutableRef with this engine.

pub fn target(&self) -> &Target

The target

pub fn register_signature( &self, func_type: FunctionType, ) -> VMSharedSignatureIndex

Register a signature

pub fn register_function_metadata( &self, func_data: VMCallerCheckedAnyfunc, ) -> VMFuncRef

Register some function metadata

pub fn lookup_signature( &self, sig: VMSharedSignatureIndex, ) -> Option<FunctionType>

Lookup a signature

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

Validates a WebAssembly module

pub fn id(&self) -> &EngineId

Engine ID

Trait Implementations

impl Clone for UniversalEngine

fn clone(&self) -> UniversalEngine

Returns a duplicate of the value.

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

Performs copy-assignment from source.