Enum InstanceAllocationStrategy 

#[non_exhaustive]
pub enum InstanceAllocationStrategy {
    OnDemand,
    Pooling(PoolingAllocationConfig),
}

Represents the module instance allocation strategy to use.

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.

OnDemand

The on-demand instance allocation strategy.

Resources related to a module instance are allocated at instantiation time and immediately deallocated when the Store referencing the instance is dropped.

This is the default allocation strategy for Wasmtime.

Pooling(PoolingAllocationConfig)

Available on crate feature pooling-allocator only.

The pooling instance allocation strategy.

A pool of resources is created in advance and module instantiation reuses resources from the pool. Resources are returned to the pool when the Store referencing the instance is dropped.

When GC is enabled, the pooling allocator requires that the GC heap configuration matches the linear memory configuration (i.e., gc_heap_reservation must equal memory_reservation, etc.). By default, if no gc_heap_* tunables are explicitly configured, they automatically inherit the memory_* values.

Implementations

impl InstanceAllocationStrategy

pub fn pooling() -> Self

Available on crate feature pooling-allocator only.

The default pooling instance allocation strategy.

Trait Implementations

impl Clone for InstanceAllocationStrategy

fn clone(&self) -> InstanceAllocationStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for InstanceAllocationStrategy

fn default() -> Self

Returns the “default value” for a type.

impl From<PoolingAllocationConfig> for InstanceAllocationStrategy

Available on crate feature pooling-allocator only.

fn from(cfg: PoolingAllocationConfig) -> InstanceAllocationStrategy

Converts to this type from the input type.