Struct WasiInstanceGuard

pub(crate) struct WasiInstanceGuard<'a> {
    borrow: Ref<'static, WasiModuleTreeHandles>,
    _pointer: &'a WasiInstanceHandlesPointer,
    _inner: Rc<RefCell<WasiModuleTreeHandles>>,
}

This non-sendable guard provides memory safe access to the WasiInstance object but only when it is constructed with certain constraints

Fields

borrow: Ref<'static, WasiModuleTreeHandles>

_pointer: &'a WasiInstanceHandlesPointer

_inner: Rc<RefCell<WasiModuleTreeHandles>>

Implementations

impl<'a> WasiInstanceGuard<'a>

pub fn memory(self) -> WasiInstanceGuardMemory<'a>

Methods from Deref<Target = WasiModuleTreeHandles>

pub(crate) fn main_module_instance_handles(&self) -> &WasiModuleInstanceHandles

Can be used to get the WasiModuleInstanceHandles of the main module. If access to the side modules’ instance handles is required, one must go through the Linker to retrieve the one they need.

pub(crate) fn static_module_instance_handles( &self, ) -> Option<&WasiModuleInstanceHandles>

Helper function to get the instance handles of a static module, or fail otherwise. See comments on ensure_static_module for more details.

pub(crate) fn ensure_static_module(&self) -> Result<(), ()>

Helper function to ensure the module isn’t dynamically linked, needed since we only support a subset of WASIX functionality for dynamically linked modules. Specifically, anything that requires asyncify is not supported right now.

pub fn memory_view<'a>( &'a self, store: &'a (impl AsStoreRef + ?Sized), ) -> MemoryView<'a>

Providers safe access to the memory (it must be initialized before it can be used)

pub fn memory(&self) -> &Memory

Providers safe access to the memory (it must be initialized before it can be used)

pub fn memory_clone(&self) -> Memory

Copy the lazy reference so that when it’s initialized during the export phase, all the other references get a copy of it

pub fn linker(&self) -> Option<&Linker>

pub fn indirect_function_table_lookup( &self, store: &mut impl AsStoreMut, index: u32, ) -> Result<Function, FunctionLookupError>

Helper function to look up a function in the indirect function table

• Returns an Errno if an error occurred.
• Returns Ok(None) if the index is out of bounds.
• Returns Ok(Some(None)) if there is no function at the index.
• Returns Ok(Some(Some(function))) if there is a function at the index.

pub fn is_closure(&self, function_id: u32) -> bool

Check if an indirect_function_table entry is reserved for closures.

Returns false if the entry is not reserved for closures.

Trait Implementations

impl Deref for WasiInstanceGuard<'_>

type Target = WasiModuleTreeHandles

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.