Struct wasmer::vm::VMInstance
pub(crate) 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
§instance: NonNull<Instance>
Implementations§
§impl VMInstance
impl VMInstance
pub unsafe fn new(
allocator: InstanceAllocator,
module: Arc<ModuleInfo, Global>,
context: &mut StoreObjects,
finished_functions: BoxedSlice<LocalFunctionIndex, FunctionBodyPtr>,
finished_function_call_trampolines: BoxedSlice<SignatureIndex, unsafe extern "C" fn(_: *mut VMContext, _: *const VMFunctionBody, _: *mut RawValue)>,
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<VMInstance, Trap>
pub unsafe fn new( allocator: InstanceAllocator, module: Arc<ModuleInfo, Global>, context: &mut StoreObjects, finished_functions: BoxedSlice<LocalFunctionIndex, FunctionBodyPtr>, finished_function_call_trampolines: BoxedSlice<SignatureIndex, unsafe extern "C" fn(_: *mut VMContext, _: *const VMFunctionBody, _: *mut RawValue)>, 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<VMInstance, 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.
pub unsafe fn finish_instantiation(
&mut self,
config: &VMConfig,
trap_handler: Option<*const dyn Fn(i32, *const siginfo_t, *const c_void) -> bool + Sync + Send>,
data_initializers: &[DataInitializer<'_>]
) -> Result<(), Trap>
pub unsafe fn finish_instantiation( &mut self, config: &VMConfig, trap_handler: Option<*const dyn Fn(i32, *const siginfo_t, *const c_void) -> bool + Sync + Send>, data_initializers: &[DataInitializer<'_>] ) -> Result<(), Trap>
Finishes the instantiation process started by Instance::new
.
Safety
Only safe to call immediately after instantiation.
pub fn vmctx(&self) -> &VMContext
pub fn vmctx(&self) -> &VMContext
Return a reference to the vmctx used by compiled wasm code.
pub 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.
pub 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!
pub fn module_ref(&self) -> &ModuleInfo
pub fn module_ref(&self) -> &ModuleInfo
Return a reference to a module.
pub 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.
pub 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
.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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.
pub 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
pub 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§
§impl Debug for VMInstance
impl Debug for VMInstance
§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)
§impl PartialEq<VMInstance> for VMInstance
impl PartialEq<VMInstance> for VMInstance
§fn eq(&self, other: &VMInstance) -> bool
fn eq(&self, other: &VMInstance) -> bool
self
and other
values to be equal, and is used
by ==
.impl Eq for VMInstance
impl StructuralEq for VMInstance
impl StructuralPartialEq for VMInstance
Auto Trait Implementations§
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<F, W, T, D> Deserialize<With<T, W>, D> for Fwhere
W: DeserializeWith<F, T, D>,
D: Fallible + ?Sized,
F: ?Sized,
impl<F, W, T, D> Deserialize<With<T, W>, D> for Fwhere W: DeserializeWith<F, T, D>, D: Fallible + ?Sized, F: ?Sized,
§fn deserialize(
&self,
deserializer: &mut D
) -> Result<With<T, W>, <D as Fallible>::Error>
fn deserialize( &self, deserializer: &mut D ) -> Result<With<T, W>, <D as Fallible>::Error>
source§impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.§impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>where
F: FnOnce(&Self) -> bool,
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>where F: FnOnce(&Self) -> bool,
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more