Struct wasmer_engine_staticlib::StaticlibEngine

pub struct StaticlibEngine { /* fields omitted */ }

A WebAssembly Staticlib Engine.

Implementations

impl StaticlibEngine

pub fn headless() -> Self

Create a headless StaticlibEngine

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 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 StaticlibEngine

fn clone(&self) -> StaticlibEngine

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Engine for StaticlibEngine

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 static 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 static 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 StaticlibEngine

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

Returns the size of the referenced value in bytes.