Struct wasmtime_runtime::PoolingInstanceAllocator

pub struct PoolingInstanceAllocator { /* private fields */ }

Implements the pooling instance allocator.

This allocator internally maintains pools of instances, memories, tables, and stacks.

Note: the resource pools are manually dropped so that the fault handler terminates correctly.

Implementations

impl PoolingInstanceAllocator

pub fn new(
    config: &PoolingInstanceAllocatorConfig,
    tunables: &Tunables
) -> Result<Self>

Creates a new pooling instance allocator with the given strategy and limits.

Trait Implementations

impl Debug for PoolingInstanceAllocator

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

Formats the value using the given formatter.

impl InstanceAllocator for PoolingInstanceAllocator

fn validate(&self, module: &Module, offsets: &VMOffsets<HostPtr>) -> Result<()>

Validates that a module is supported by the allocator.

fn allocate_index(&self, req: &InstanceAllocationRequest<'_>) -> Result<usize>

Optionally allocates an allocator-defined index for the req provided.

fn deallocate_index(&self, index: usize)

Deallocates indices allocated by allocate_index.

fn allocate_memories(
    &self,
    index: usize,
    req: &mut InstanceAllocationRequest<'_>,
    memories: &mut PrimaryMap<DefinedMemoryIndex, Memory>
) -> Result<()>

Attempts to allocate all defined linear memories for a module.

fn deallocate_memories(
    &self,
    index: usize,
    mems: &mut PrimaryMap<DefinedMemoryIndex, Memory>
)

Deallocates all memories provided, optionally reclaiming resources for the pooling allocator for example.

fn allocate_tables(
    &self,
    index: usize,
    req: &mut InstanceAllocationRequest<'_>,
    tables: &mut PrimaryMap<DefinedTableIndex, Table>
) -> Result<()>

Same as allocate_memories, but for tables.

fn deallocate_tables(
    &self,
    index: usize,
    tables: &mut PrimaryMap<DefinedTableIndex, Table>
)

Same as deallocate_memories, but for tables.

fn purge_module(&self, module: CompiledModuleId)

Purges all lingering resources related to module from within this allocator.

fn allocate(&self, req: InstanceAllocationRequest<'_>) -> Result<InstanceHandle>

Allocates a fresh InstanceHandle for the req given.

fn deallocate(&self, handle: &mut InstanceHandle)

Deallocates the provided instance.