Trait wasmer::Tunables

pub trait Tunables: MemoryUsage {
    fn memory_style(&self, memory: &MemoryType) -> MemoryStyle;
    fn table_style(&self, table: &TableType) -> TableStyle;
    fn create_host_memory(
        &self, 
        ty: &MemoryType, 
        style: &MemoryStyle
    ) -> Result<Arc<dyn Memory + 'static>, MemoryError>;
    unsafe fn create_vm_memory(
        &self, 
        ty: &MemoryType, 
        style: &MemoryStyle, 
        vm_definition_location: NonNull<VMMemoryDefinition>
    ) -> Result<Arc<dyn Memory + 'static>, MemoryError>;
    fn create_host_table(
        &self, 
        ty: &TableType, 
        style: &TableStyle
    ) -> Result<Arc<dyn Table + 'static>, String>;
    unsafe fn create_vm_table(
        &self, 
        ty: &TableType, 
        style: &TableStyle, 
        vm_definition_location: NonNull<VMTableDefinition>
    ) -> Result<Arc<dyn Table + 'static>, String>;

    fn create_global(&self, ty: GlobalType) -> Result<Arc<Global>, String> { ... }
    unsafe fn create_memories(
        &self, 
        module: &ModuleInfo, 
        memory_styles: &PrimaryMap<MemoryIndex, MemoryStyle>, 
        memory_definition_locations: &[NonNull<VMMemoryDefinition>]
    ) -> Result<PrimaryMap<LocalMemoryIndex, Arc<dyn Memory + 'static>>, LinkError> { ... }
    unsafe fn create_tables(
        &self, 
        module: &ModuleInfo, 
        table_styles: &PrimaryMap<TableIndex, TableStyle>, 
        table_definition_locations: &[NonNull<VMTableDefinition>]
    ) -> Result<PrimaryMap<LocalTableIndex, Arc<dyn Table + 'static>>, LinkError> { ... }
    fn create_globals(
        &self, 
        module: &ModuleInfo
    ) -> Result<PrimaryMap<LocalGlobalIndex, Arc<Global>>, LinkError> { ... }
}

An engine delegates the creation of memories, tables, and globals to a foreign implementor of this trait.

Required methods

fn memory_style(&self, memory: &MemoryType) -> MemoryStyle

Construct a MemoryStyle for the provided MemoryType

fn table_style(&self, table: &TableType) -> TableStyle

Construct a TableStyle for the provided TableType

fn create_host_memory(
    &self,
    ty: &MemoryType,
    style: &MemoryStyle
) -> Result<Arc<dyn Memory + 'static>, MemoryError>

Create a memory owned by the host given a MemoryType and a MemoryStyle.

unsafe fn create_vm_memory(
    &self,
    ty: &MemoryType,
    style: &MemoryStyle,
    vm_definition_location: NonNull<VMMemoryDefinition>
) -> Result<Arc<dyn Memory + 'static>, MemoryError>

Create a memory owned by the VM given a MemoryType and a MemoryStyle.

Safety

• vm_definition_location must point to a valid location in VM memory.

fn create_host_table(
    &self,
    ty: &TableType,
    style: &TableStyle
) -> Result<Arc<dyn Table + 'static>, String>

Create a table owned by the host given a TableType and a TableStyle.

unsafe fn create_vm_table(
    &self,
    ty: &TableType,
    style: &TableStyle,
    vm_definition_location: NonNull<VMTableDefinition>
) -> Result<Arc<dyn Table + 'static>, String>

Create a table owned by the VM given a TableType and a TableStyle.

Safety

• vm_definition_location must point to a valid location in VM memory.

Provided methods

fn create_global(&self, ty: GlobalType) -> Result<Arc<Global>, String>

Create a global with an unset value.

unsafe fn create_memories(
    &self,
    module: &ModuleInfo,
    memory_styles: &PrimaryMap<MemoryIndex, MemoryStyle>,
    memory_definition_locations: &[NonNull<VMMemoryDefinition>]
) -> Result<PrimaryMap<LocalMemoryIndex, Arc<dyn Memory + 'static>>, LinkError>

Allocate memory for just the memories of the current module.

unsafe fn create_tables(
    &self,
    module: &ModuleInfo,
    table_styles: &PrimaryMap<TableIndex, TableStyle>,
    table_definition_locations: &[NonNull<VMTableDefinition>]
) -> Result<PrimaryMap<LocalTableIndex, Arc<dyn Table + 'static>>, LinkError>

Allocate memory for just the tables of the current module.

fn create_globals(
    &self,
    module: &ModuleInfo
) -> Result<PrimaryMap<LocalGlobalIndex, Arc<Global>>, LinkError>

Allocate memory for just the globals of the current module, with initializers applied.

Implementors

impl Tunables for BaseTunables

fn memory_style(&self, memory: &MemoryType) -> MemoryStyle

Get a MemoryStyle for the provided MemoryType

fn table_style(&self, _table: &TableType) -> TableStyle

Get a TableStyle for the provided TableType.

fn create_host_memory(
    &self,
    ty: &MemoryType,
    style: &MemoryStyle
) -> Result<Arc<dyn Memory>, MemoryError>

Create a memory owned by the host given a MemoryType and a MemoryStyle.

unsafe fn create_vm_memory(
    &self,
    ty: &MemoryType,
    style: &MemoryStyle,
    vm_definition_location: NonNull<VMMemoryDefinition>
) -> Result<Arc<dyn Memory>, MemoryError>

Create a memory owned by the VM given a MemoryType and a MemoryStyle.

Safety

• vm_definition_location must point to a valid, owned VMMemoryDefinition, for example in VMContext.

fn create_host_table(
    &self,
    ty: &TableType,
    style: &TableStyle
) -> Result<Arc<dyn Table>, String>

Create a table owned by the host given a TableType and a TableStyle.

unsafe fn create_vm_table(
    &self,
    ty: &TableType,
    style: &TableStyle,
    vm_definition_location: NonNull<VMTableDefinition>
) -> Result<Arc<dyn Table>, String>

Create a table owned by the VM given a TableType and a TableStyle.

Safety

• vm_definition_location must point to a valid, owned VMTableDefinition, for example in VMContext.