Trait wasmer_engine::Engine

pub trait Engine: MemoryUsage {
    fn target(&self) -> &Target;
    fn register_signature(
        &self, 
        func_type: &FunctionType
    ) -> VMSharedSignatureIndex;
    fn register_function_metadata(
        &self, 
        func_data: VMCallerCheckedAnyfunc
    ) -> VMFuncRef;
    fn lookup_signature(
        &self, 
        sig: VMSharedSignatureIndex
    ) -> Option<FunctionType>;
    fn validate(&self, binary: &[u8]) -> Result<(), CompileError>;
    fn compile(
        &self, 
        binary: &[u8], 
        tunables: &dyn Tunables
    ) -> Result<Arc<dyn Artifact>, CompileError>;
    unsafe fn deserialize(
        &self, 
        bytes: &[u8]
    ) -> Result<Arc<dyn Artifact>, DeserializeError>;
    fn id(&self) -> &EngineId;
    fn cloned(&self) -> Arc<dyn Engine + Send + Sync>;

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

A unimplemented Wasmer Engine.

This trait is used by implementors to implement custom engines such as: Universal or Native.

The product that an Engine produces and consumes is the Artifact.

Required methods

fn target(&self) -> &Target

Gets the target

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

Register a signature

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

Register a function’s data.

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

Safety

The serialized content must represent a serialized WebAssembly module.

fn id(&self) -> &EngineId

A unique identifier for this object.

This exists to allow us to compare two Engines for equality. Otherwise, comparing two trait objects unsafely relies on implementation details of trait representation.

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

Clone the engine

Provided methods

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

Deserializes a WebAssembly module from a path

Safety

The file’s content must represent a serialized WebAssembly module.

Implementors