Struct wasmer_engine_native::NativeEngine

pub struct NativeEngine { /* fields omitted */ }

A WebAssembly Native Engine.

Implementations

impl NativeEngine

pub fn headless() -> Self

Create a headless NativeEngine

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 NativeEngine

fn clone(&self) -> NativeEngine

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Engine for NativeEngine

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 function_call_trampoline(
    &self,
    sig: VMSharedSignatureIndex
) -> Option<VMTrampoline>

Retrieves a trampoline given 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 id(&self) -> &EngineId

A unique identifier for this object.

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

Clone the engine