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.