Struct VmState

pub struct VmState {
    pub regs: [u64; 13],
    pub program_counter: u64,
    pub frame_number: u64,
    pub mapped_heap_pages: RangeSet,
    pub resident_pages: RangeSet,
}

Inner VM state.

Fields

regs: [u64; 13]

Registers.

program_counter: u64

Program counter.

frame_number: u64

The current frame number.

mapped_heap_pages: RangeSet

Mapped heap memory pages’ indices.

These pages were allocated by the guest but not necessarily read from/written to.

Note that it’s possible to include only a subset of the pages if you’re sure that they will not be touched again during the program run. Howeve,r if such a page is touched the engine will panic.

resident_pages: RangeSet

All memory pages that were read from/written to by the guest but haven’t been unmapped yet.

Note that it’s possible to include only a subset of the pages if you’re sure that they will not be touched again during the program run. However, if such a page is touched the engine will silently initialize it from the default: from zeroes for stack/heap and from the program’s RW data section for RW data. The program might continue without an error after that, but the output will most likely be incorrect.

Implementations

impl VmState

pub const fn initial() -> Self

Create initial state.

Trait Implementations

impl Clone for VmState

fn clone(&self) -> VmState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VmState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Decode for VmState

fn decode<__CodecInputEdqy: Input>( __codec_input_edqy: &mut __CodecInputEdqy, ) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self>, ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl Encode for VmState

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode_to<__CodecOutputEdqy: Output + ?Sized>( &self, __codec_dest_edqy: &mut __CodecOutputEdqy, )

Convert self to a slice and append it to the destination.

fn encode(&self) -> Vec<u8>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R

where F: FnOnce(&[u8]) -> R,

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl EncodeLike for VmState