Struct wasmer::UniversalEngine

source · [−]

pub struct UniversalEngine { /* private fields */ }

Expand description

A WebAssembly Universal Engine.

Implementations

source

impl UniversalEngine

source

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

Create a new UniversalEngine with the given config

source

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

source

impl Clone for UniversalEngine

source

pub fn clone(&self) -> UniversalEngine

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 UniversalEngine

source

pub fn target(&self) -> &Target

The target

source

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

Register a signature

source

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

Lookup a signature

source

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

Validates a WebAssembly module

source

pub fn compile(
 &self,
 binary: &[u8 ],
 tunables: &dyn Tunables
) -> Result<Arc<dyn Artifact + 'static>, CompileError>

Compile a WebAssembly binary

source

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

Deserializes a WebAssembly module

source

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

Register a function’s data.

source

pub fn id(&self) -> &EngineId

A unique identifier for this object. Read more

source

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

Clone the engine

source

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

Deserializes a WebAssembly module from a path Read more

source

impl MemoryUsage for UniversalEngine

source

pub 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 UniversalEngine

impl Send for UniversalEngine

impl Sync for UniversalEngine

impl Unpin for UniversalEngine

impl UnwindSafe for UniversalEngine

Blanket Implementations

source

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

source

pub 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

pub 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

pub 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

pub 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

pub 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

pub 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

pub fn into(self) -> U

Calls U::from(self).

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

source

impl<T> Pointable for T

source

pub const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

source

pub unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

source

pub unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

source

pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

source

pub unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

source

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

pub fn to_owned(&self) -> T

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

source

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

🔬 This is a nightly-only experimental API. (toowned_clone_into)

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

pub 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

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

Performs the conversion.

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::UniversalEngine

Implementations

impl UniversalEngine

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

pub fn headless() -> UniversalEngine

Trait Implementations

impl Clone for UniversalEngine

pub fn clone(&self) -> UniversalEngine

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

impl Engine for UniversalEngine

pub fn target(&self) -> &Target

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

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

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

pub fn compile( &self, binary: &[u8], tunables: &dyn Tunables) -> Result<Arc<dyn Artifact + 'static>, CompileError>

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

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

pub fn id(&self) -> &EngineId

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

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

impl MemoryUsage for UniversalEngine

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

Auto Trait Implementations

impl RefUnwindSafe for UniversalEngine

impl Send for UniversalEngine

impl Sync for UniversalEngine

impl Unpin for UniversalEngine

impl UnwindSafe for UniversalEngine

Blanket Implementations

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

pub fn type_id(&self) -> TypeId

impl<T> ArchivePointee for T

type ArchivedMetadata = ()

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

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

pub fn borrow(&self) -> &T

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

pub 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,

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

impl<T> From<T> for T

pub 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>,

pub fn into(self) -> U

impl<T> Pointable for T

pub const ALIGN: usize

type Init = T

pub unsafe fn init(init: <T as Pointable>::Init) -> usize

pub unsafe fn deref<'a>(ptr: usize) -> &'a T

pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

pub unsafe fn drop(ptr: usize)

impl<T> Pointee for T

type Metadata = ()

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

type Owned = T

pub fn to_owned(&self) -> T

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

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

type Error = Infallible

pub 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

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

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 new(
compiler: Box<dyn Compiler + 'static, Global>,
target: Target,
features: Features
) -> UniversalEngine

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

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

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

pub fn compile(
&self,
binary: &[u8 ],
tunables: &dyn Tunables
) -> Result<Arc<dyn Artifact + 'static>, CompileError>

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

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

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

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

pub 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,

pub 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>,

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