Struct wasmer_engine_dylib::DylibEngine

source · [−]

pub struct DylibEngine { /* private fields */ }

Expand description

A WebAssembly Dylib Engine.

Implementations

source

impl DylibEngine

source

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).

source

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

source

impl Clone for DylibEngine

source

fn clone(&self) -> DylibEngine

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl Engine for DylibEngine

source

fn target(&self) -> &Target

The target

source

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

Register a signature

source

fn lookup_signature(&self, sig: VMSharedSignatureIndex) -> Option<FunctionType>

Lookup a signature

source

fn validate(&self, binary: &[u8 ]) -> Result<(), CompileError>

Validates a WebAssembly module

source

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).

source

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

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

source

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.

source

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

Register a function’s data.

source

fn id(&self) -> &EngineId

A unique identifier for this object. Read more

source

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

Clone the engine

source

impl MemoryUsage for DylibEngine

source

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

Returns the size of the referenced value in bytes. Read more

Auto Trait Implementations

impl RefUnwindSafe for DylibEngine

impl Send for DylibEngine

impl Sync for DylibEngine

impl Unpin for DylibEngine

impl UnwindSafe for DylibEngine

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> ArchivePointee for T

type ArchivedMetadata = ()

The archived version of the pointer metadata for this type.

source

fn pointer_metadata(
&<T as ArchivePointee>::ArchivedMetadata
) -> <T as Pointee>::Metadata

Converts some archived metadata to the pointer metadata for itself.

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<F, W, T, D> Deserialize<With<T, W>, D> for F where
 W: DeserializeWith<F, T, D>,
 D: Fallible + ?Sized,
 F: ?Sized,

source

fn deserialize(
&self,
deserializer: &mut D
) -> Result<With<T, W>, <D as Fallible>::Error>

Deserializes using the given deserializer

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T> Instrument for T

source

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

source

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> Pointee for T

type Metadata = ()

The type for metadata in pointers and references to Self.

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

source

impl<T> Upcastable for T where
T: 'static + Any + Send + Sync,

source

fn upcast_any_ref(&self) -> &(dyn Any + 'static)

upcast ref

source

fn upcast_any_mut(&mut self) -> &mut (dyn Any + 'static)

upcast mut ref

source

fn upcast_any_box(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>

upcast boxed dyn

source

impl<T> WithSubscriber for T

source

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

source

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

Struct wasmer_engine_dylib::DylibEngine

Implementations

impl DylibEngine

pub fn headless() -> Self

pub fn set_deterministic_prefixer<F>(&mut self, prefixer: F) where F: Fn(&[u8]) -> String + Send + 'static,

Trait Implementations

impl Clone for DylibEngine

fn clone(&self) -> DylibEngine

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

impl Engine for DylibEngine

fn target(&self) -> &Target

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

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>

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

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

fn id(&self) -> &EngineId

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

impl MemoryUsage for DylibEngine

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

Auto Trait Implementations

impl RefUnwindSafe for DylibEngine

impl Send for DylibEngine

impl Sync for DylibEngine

impl Unpin for DylibEngine

impl UnwindSafe for DylibEngine

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> ArchivePointee for T

type ArchivedMetadata = ()

fn pointer_metadata( &<T as ArchivePointee>::ArchivedMetadata) -> <T as Pointee>::Metadata

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<F, W, T, D> Deserialize<With<T, W>, D> for F where W: DeserializeWith<F, T, D>, D: Fallible + ?Sized, F: ?Sized,

fn deserialize( &self, deserializer: &mut D) -> Result<With<T, W>, <D as Fallible>::Error>

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T> Pointee for T

type Metadata = ()

impl<T> ToOwned for T where T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<T> Upcastable for T where T: 'static + Any + Send + Sync,

fn upcast_any_ref(&self) -> &(dyn Any + 'static)

fn upcast_any_mut(&mut self) -> &mut (dyn Any + 'static)

fn upcast_any_box(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where S: Into<Dispatch>,

fn with_current_subscriber(self) -> WithDispatch<Self>

pub fn set_deterministic_prefixer<F>(&mut self, prefixer: F) where
F: Fn(&[u8 ]) -> String + Send + 'static,

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>

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

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

impl<T> Any for T where
T: 'static + ?Sized,

fn pointer_metadata(
&<T as ArchivePointee>::ArchivedMetadata
) -> <T as Pointee>::Metadata

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<F, W, T, D> Deserialize<With<T, W>, D> for F where
W: DeserializeWith<F, T, D>,
D: Fallible + ?Sized,
F: ?Sized,

fn deserialize(
&self,
deserializer: &mut D
) -> Result<With<T, W>, <D as Fallible>::Error>

impl<T, U> Into<U> for T where
U: From<T>,

impl<T> ToOwned for T where
T: Clone,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

impl<T> Upcastable for T where
T: 'static + Any + Send + Sync,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,