Struct wasmer_vm::instance::VMInstance
source · pub struct VMInstance {
instance_layout: Layout,
instance: NonNull<Instance>,
}
Expand description
A handle holding an Instance
of a WebAssembly module.
This is more or less a public facade of the private Instance
,
providing useful higher-level API.
Fields§
§instance_layout: Layout
The layout of Instance
(which can vary).
instance: NonNull<Instance>
The Instance
itself.
Instance
must not be dropped manually by Rust, because it’s
allocated manually with alloc
and a specific layout (Rust
would be able to drop Instance
itself but it will imply a
memory leak because of alloc
).
No one in the code has a copy of the Instance
’s
pointer. Self
is the only one.
Implementations§
source§impl VMInstance
impl VMInstance
sourcepub unsafe fn new(
allocator: InstanceAllocator,
module: Arc<ModuleInfo>,
context: &mut StoreObjects,
finished_functions: BoxedSlice<LocalFunctionIndex, FunctionBodyPtr>,
finished_function_call_trampolines: BoxedSlice<SignatureIndex, VMTrampoline>,
finished_memories: BoxedSlice<LocalMemoryIndex, InternalStoreHandle<VMMemory>>,
finished_tables: BoxedSlice<LocalTableIndex, InternalStoreHandle<VMTable>>,
finished_globals: BoxedSlice<LocalGlobalIndex, InternalStoreHandle<VMGlobal>>,
imports: Imports,
vmshared_signatures: BoxedSlice<SignatureIndex, VMSharedSignatureIndex>,
) -> Result<Self, Trap>
pub unsafe fn new( allocator: InstanceAllocator, module: Arc<ModuleInfo>, context: &mut StoreObjects, finished_functions: BoxedSlice<LocalFunctionIndex, FunctionBodyPtr>, finished_function_call_trampolines: BoxedSlice<SignatureIndex, VMTrampoline>, finished_memories: BoxedSlice<LocalMemoryIndex, InternalStoreHandle<VMMemory>>, finished_tables: BoxedSlice<LocalTableIndex, InternalStoreHandle<VMTable>>, finished_globals: BoxedSlice<LocalGlobalIndex, InternalStoreHandle<VMGlobal>>, imports: Imports, vmshared_signatures: BoxedSlice<SignatureIndex, VMSharedSignatureIndex>, ) -> Result<Self, Trap>
Create a new VMInstance
pointing at a new Instance
.
§Safety
This method is not necessarily inherently unsafe to call, but in general
the APIs of an Instance
are quite unsafe and have not been really
audited for safety that much. As a result the unsafety here on this
method is a low-overhead way of saying “this is an extremely unsafe type
to work with”.
Extreme care must be taken when working with VMInstance
and it’s
recommended to have relatively intimate knowledge of how it works
internally if you’d like to do so. If possible it’s recommended to use
the wasmer
crate API rather than this type since that is vetted for
safety.
However the following must be taken care of before calling this function:
- The memory at
instance.tables_ptr()
must be initialized with data for all the local tables. - The memory at
instance.memories_ptr()
must be initialized with data for all the local memories.
sourcepub(crate) fn instance_mut(&mut self) -> &mut Instance
pub(crate) fn instance_mut(&mut self) -> &mut Instance
Return a mutable reference to the contained Instance
.
sourcepub unsafe fn finish_instantiation(
&mut self,
config: &VMConfig,
trap_handler: Option<*const TrapHandlerFn<'static>>,
data_initializers: &[DataInitializer<'_>],
) -> Result<(), Trap>
pub unsafe fn finish_instantiation( &mut self, config: &VMConfig, trap_handler: Option<*const TrapHandlerFn<'static>>, data_initializers: &[DataInitializer<'_>], ) -> Result<(), Trap>
Finishes the instantiation process started by Instance::new
.
§Safety
Only safe to call immediately after instantiation.
sourcepub fn vmctx_ptr(&self) -> *mut VMContext
pub fn vmctx_ptr(&self) -> *mut VMContext
Return a raw pointer to the vmctx used by compiled wasm code.
sourcepub fn vmoffsets(&self) -> &VMOffsets
pub fn vmoffsets(&self) -> &VMOffsets
Return a reference to the VMOffsets
to get offsets in the
Self::vmctx_ptr
region. Be careful when doing pointer
arithmetic!
sourcepub fn module_ref(&self) -> &ModuleInfo
pub fn module_ref(&self) -> &ModuleInfo
Return a reference to a module.
sourcepub fn lookup(&mut self, field: &str) -> Option<VMExtern>
pub fn lookup(&mut self, field: &str) -> Option<VMExtern>
Lookup an export with the given name.
sourcepub fn lookup_by_declaration(&mut self, export: ExportIndex) -> VMExtern
pub fn lookup_by_declaration(&mut self, export: ExportIndex) -> VMExtern
Lookup an export with the given export declaration.
sourcepub fn exports(&self) -> Iter<'_, String, ExportIndex>
pub fn exports(&self) -> Iter<'_, String, ExportIndex>
Return an iterator over the exports of this instance.
Specifically, it provides access to the key-value pairs, where the keys
are export names, and the values are export declarations which can be
resolved lookup_by_declaration
.
sourcepub fn memory_index(&self, memory: &VMMemoryDefinition) -> LocalMemoryIndex
pub fn memory_index(&self, memory: &VMMemoryDefinition) -> LocalMemoryIndex
Return the memory index for the given VMMemoryDefinition
in this instance.
sourcepub fn memory_grow<IntoPages>(
&mut self,
memory_index: LocalMemoryIndex,
delta: IntoPages,
) -> Result<Pages, MemoryError>where
IntoPages: Into<Pages>,
pub fn memory_grow<IntoPages>(
&mut self,
memory_index: LocalMemoryIndex,
delta: IntoPages,
) -> Result<Pages, MemoryError>where
IntoPages: Into<Pages>,
Grow memory in this instance by the specified amount of pages.
Returns None
if memory can’t be grown by the specified amount
of pages.
sourcepub fn table_index(&self, table: &VMTableDefinition) -> LocalTableIndex
pub fn table_index(&self, table: &VMTableDefinition) -> LocalTableIndex
Return the table index for the given VMTableDefinition
in this instance.
sourcepub fn table_grow(
&mut self,
table_index: LocalTableIndex,
delta: u32,
init_value: TableElement,
) -> Option<u32>
pub fn table_grow( &mut self, table_index: LocalTableIndex, delta: u32, init_value: TableElement, ) -> Option<u32>
Grow table in this instance by the specified amount of pages.
Returns None
if memory can’t be grown by the specified amount
of pages.
sourcepub fn table_get(
&self,
table_index: LocalTableIndex,
index: u32,
) -> Option<TableElement>
pub fn table_get( &self, table_index: LocalTableIndex, index: u32, ) -> Option<TableElement>
Get table element reference.
Returns None
if index is out of bounds.
sourcepub fn table_set(
&mut self,
table_index: LocalTableIndex,
index: u32,
val: TableElement,
) -> Result<(), Trap>
pub fn table_set( &mut self, table_index: LocalTableIndex, index: u32, val: TableElement, ) -> Result<(), Trap>
Set table element reference.
Returns an error if the index is out of bounds
sourcepub fn get_local_table(&mut self, index: LocalTableIndex) -> &mut VMTable
pub fn get_local_table(&mut self, index: LocalTableIndex) -> &mut VMTable
Get a table defined locally within this module.
Trait Implementations§
source§impl Debug for VMInstance
impl Debug for VMInstance
source§impl Drop for VMInstance
impl Drop for VMInstance
VMInstance are created with an InstanceAllocator and it will “consume” the memory So the Drop here actualy free it (else it would be leaked)
source§impl PartialEq for VMInstance
impl PartialEq for VMInstance
source§fn eq(&self, other: &VMInstance) -> bool
fn eq(&self, other: &VMInstance) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl StoreObject for VMInstance
impl StoreObject for VMInstance
fn list(ctx: &StoreObjects) -> &Vec<Self>
fn list_mut(ctx: &mut StoreObjects) -> &mut Vec<Self>
impl Eq for VMInstance
impl StructuralPartialEq for VMInstance
Auto Trait Implementations§
impl Freeze for VMInstance
impl !RefUnwindSafe for VMInstance
impl !Send for VMInstance
impl !Sync for VMInstance
impl Unpin for VMInstance
impl !UnwindSafe for VMInstance
Blanket Implementations§
§impl<T> ArchivePointee for T
impl<T> ArchivePointee for T
§type ArchivedMetadata = ()
type ArchivedMetadata = ()
§fn pointer_metadata(
_: &<T as ArchivePointee>::ArchivedMetadata,
) -> <T as Pointee>::Metadata
fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata, ) -> <T as Pointee>::Metadata
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.