Struct DylibEngine

pub struct DylibEngine { /* private fields */ }

A WebAssembly Dylib Engine.

Implementations

impl DylibEngine

pub fn headless() -> Self

Create a headless DylibEngine

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 set_deterministic_prefixer<F>(&mut self, prefixer: F)

where F: Fn(&[u8]) -> String + Send + 'static,

Sets a prefixer for the wasm module, so we can avoid any collisions in the exported function names on the generated shared object.

This, allows us to rather than have functions named wasmer_function_1 to be named wasmer_function_PREFIX_1.

Important

This prefixer function should be deterministic, so the compilation remains deterministic.

Trait Implementations

impl Clone for DylibEngine

fn clone(&self) -> DylibEngine

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Engine for DylibEngine

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 (it will fail because the compiler flag is disabled).

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

Deserializes a WebAssembly module (binary content of a shared object file)

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

Deserializes a WebAssembly module from a path It should point to a shared object file generated by this engine.

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

impl MemoryUsage for DylibEngine

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

Returns the size of the referenced value in bytes.