Struct wasmer::UniversalEngine

pub struct UniversalEngine { /* fields omitted */ }

A WebAssembly Universal Engine.

Implementations

impl UniversalEngine

pub fn new(
    compiler: Box<dyn Compiler + 'static, Global>,
    target: Target,
    features: Features
) -> UniversalEngine

Create a new UniversalEngine with the given config

pub fn headless() -> UniversalEngine

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

pub 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

pub fn target(&self) -> &Target

The target

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

Register a signature

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 compile(
    &self,
    binary: &[u8],
    tunables: &dyn Tunables
) -> Result<Arc<dyn Artifact + 'static>, CompileError>

Compile a WebAssembly binary

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

Deserializes a WebAssembly module

pub fn use_signals(&self) -> bool

If this engine needs to install POSIX signal handlers.

pub fn id(&self) -> &EngineId

A unique identifier for this object.

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

Clone the engine

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

Deserializes a WebAssembly module from a path

impl MemoryUsage for UniversalEngine

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

Returns the size of the referenced value in bytes.