Struct sp_sandbox::Memory

pub struct Memory { /* fields omitted */ }

Reference to a sandboxed linear memory, that will be used by the guest module.

The memory can't be directly accessed by supervisor, but only through designated functions get and set.

Implementations

impl Memory

pub fn new(initial: u32, maximum: Option<u32>) -> Result<Memory, Error>

Construct a new linear memory instance.

The memory allocated with initial number of pages specified by initial. Minimal possible value for initial is 0 and maximum possible is 65536. (Since maximum addressable memory is 2³² = 4GiB = 65536 * 64KiB).

It is possible to limit maximum number of pages this memory instance can have by specifying maximum. If not specified, this memory instance would be able to allocate up to 4GiB.

Allocated memory is always zeroed.

pub fn get(&self, ptr: u32, buf: &mut [u8]) -> Result<(), Error>

Read a memory area at the address ptr with the size of the provided slice buf.

Returns Err if the range is out-of-bounds.

pub fn set(&self, ptr: u32, value: &[u8]) -> Result<(), Error>

Write a memory area at the address ptr with contents of the provided slice buf.

Returns Err if the range is out-of-bounds.

Trait Implementations

impl Clone for Memory

fn clone(&self) -> Memory

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.