Struct UniversalEngine

pub struct UniversalEngine { /* private fields */ }

A WebAssembly Universal Engine.

Implementations

impl UniversalEngine

pub fn headless() -> 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).

Trait Implementations

impl Clone for UniversalEngine

fn clone(&self) -> UniversalEngine

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Engine for UniversalEngine

fn target(&self) -> &Target

The target

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

Register a signature

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

Lookup a signature

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

Validates a WebAssembly module

fn compile( &self, _binary: &[u8], _tunables: &dyn Tunables, ) -> Result<Arc<dyn Artifact>, CompileError>

Compile a WebAssembly binary

unsafe fn deserialize( &self, bytes: &[u8], ) -> Result<Arc<dyn Artifact>, DeserializeError>

Deserializes a WebAssembly module

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

Register a function’s data.

fn id(&self) -> &EngineId

A unique identifier for this object.

fn cloned(&self) -> Arc<dyn Engine + Send + Sync>

Clone the engine

unsafe fn deserialize_from_file( &self, file_ref: &Path, ) -> Result<Arc<dyn Artifact>, DeserializeError>

Deserializes a WebAssembly module from a path

impl MemoryUsage for UniversalEngine

fn size_of_val(&self, visited: &mut dyn MemoryUsageTracker) -> usize

Returns the size of the referenced value in bytes.