Struct wiggle::wasmtime::WasmtimeGuestMemory

pub struct WasmtimeGuestMemory<'a> { /* private fields */ }

Lightweight wasmtime::Memory wrapper so we can implement the wiggle::GuestMemory trait on it.

Implementations

impl<'a> WasmtimeGuestMemory<'a>

pub fn new(mem: &'a mut [u8]) -> Self

pub fn shared(mem: &'a [UnsafeCell<u8>]) -> Self

Trait Implementations

impl GuestMemory for WasmtimeGuestMemory<'_>

fn base(&self) -> &[UnsafeCell<u8>]

Returns the base allocation of this guest memory, located in host memory.

fn has_outstanding_borrows(&self) -> bool

Indicates whether any outstanding borrows are known to the GuestMemory. This function must be false in order for it to be safe to recursively call into a WebAssembly module, or to manipulate the WebAssembly memory by any other means.

fn is_shared_borrowed(&self, r: Region) -> bool

Check if a region of linear memory has any shared borrows.

fn is_mut_borrowed(&self, r: Region) -> bool

Check if a region of linear memory is exclusively borrowed. This is called during any GuestPtr::read or GuestPtr::write operation to ensure that wiggle is not reading or writing a region of memory which Rust believes it has exclusive access to.

fn shared_borrow(&self, r: Region) -> Result<BorrowHandle, GuestError>

Shared borrow a region of linear memory. This is used when constructing a GuestSlice or GuestStr. Those types will give Rust & (shared reference) access to the region of linear memory.

fn mut_borrow(&self, r: Region) -> Result<BorrowHandle, GuestError>

Exclusively borrow a region of linear memory. This is used when constructing a GuestSliceMut or GuestStrMut. Those types will give Rust &mut access to the region of linear memory, therefore, the GuestMemory impl must guarantee that at most one BorrowHandle is issued to a given region, GuestMemory::has_outstanding_borrows is true for the duration of the borrow, and that GuestMemory::is_mut_borrowed of any overlapping region is false for the duration of the borrow.

fn shared_unborrow(&self, h: BorrowHandle)

Unborrow a previously borrowed shared region. As long as GuestSlice and GuestStr are implemented correctly, a shared BorrowHandle should only be unborrowed once.

fn mut_unborrow(&self, h: BorrowHandle)

Unborrow a previously borrowed mutable region. As long as GuestSliceMut and GuestStrMut are implemented correctly, a mut BorrowHandle should only be unborrowed once.

fn is_shared_memory(&self) -> bool

Check if the underlying memory is shared across multiple threads; e.g., with a WebAssembly shared memory.

fn ptr<'a, T>(&'a self, offset: T::Pointer) -> GuestPtr<'a, T>where Self: Sized, T: ?Sized + Pointee,

Convenience method for creating a GuestPtr at a particular offset.

impl Send for WasmtimeGuestMemory<'_>

impl Sync for WasmtimeGuestMemory<'_>