Enum InstantiationStrategy

#[non_exhaustive]
pub enum InstantiationStrategy {
    PoolingCopyOnWrite,
    RecreateInstanceCopyOnWrite,
    Pooling,
    RecreateInstance,
}

The instantiation strategy to use for the WASM executor.

All of the CoW strategies (with CopyOnWrite suffix) are only supported when either: a) we’re running on Linux, b) we’re running on an Unix-like system and we’re precompiling our module beforehand and instantiating from a file.

If the CoW variant of a strategy is unsupported the executor will fall back to the non-CoW equivalent.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

PoolingCopyOnWrite

Pool the instances to avoid initializing everything from scratch on each instantiation. Use copy-on-write memory when possible.

This is the fastest instantiation strategy.

RecreateInstanceCopyOnWrite

Recreate the instance from scratch on every instantiation. Use copy-on-write memory when possible.

Pooling

Pool the instances to avoid initializing everything from scratch on each instantiation.

RecreateInstance

Recreate the instance from scratch on every instantiation. Very slow.

Trait Implementations

impl Clone for InstantiationStrategy

fn clone(&self) -> InstantiationStrategy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for InstantiationStrategy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for InstantiationStrategy

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for InstantiationStrategy

fn eq(&self, other: &InstantiationStrategy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for InstantiationStrategy

impl Eq for InstantiationStrategy

impl StructuralPartialEq for InstantiationStrategy