Trait GuestMemory 

pub trait GuestMemory: Send + Sync {
    // Required methods
    fn read(
        &self,
        addr: GuestAddress,
        buf: &mut [u8],
    ) -> Result<(), HypervisorError>;
    fn write(
        &self,
        addr: GuestAddress,
        buf: &[u8],
    ) -> Result<(), HypervisorError>;
    fn get_host_address(
        &self,
        addr: GuestAddress,
    ) -> Result<*mut u8, HypervisorError>;
    fn size(&self) -> u64;
    fn enable_dirty_tracking(&mut self) -> Result<(), HypervisorError>;
    fn disable_dirty_tracking(&mut self) -> Result<(), HypervisorError>;
    fn get_dirty_pages(&mut self) -> Result<Vec<DirtyPageInfo>, HypervisorError>;
    fn dump_all(&self, buf: &mut [u8]) -> Result<(), HypervisorError>;
}

Guest memory trait for reading/writing guest physical memory.

Required Methods

fn read( &self, addr: GuestAddress, buf: &mut [u8], ) -> Result<(), HypervisorError>

Reads bytes from guest memory.

Errors

Returns an error if the read fails.

fn write(&self, addr: GuestAddress, buf: &[u8]) -> Result<(), HypervisorError>

Writes bytes to guest memory.

Errors

Returns an error if the write fails.

fn get_host_address( &self, addr: GuestAddress, ) -> Result<*mut u8, HypervisorError>

Gets the host virtual address for a guest physical address.

This is used for zero-copy operations.

Safety

The returned pointer is only valid while the memory mapping exists.

Errors

Returns an error if the address is not mapped.

fn size(&self) -> u64

Returns the total size of guest memory in bytes.

fn enable_dirty_tracking(&mut self) -> Result<(), HypervisorError>

Enables dirty page tracking.

After enabling, use get_dirty_pages() to retrieve modified pages.

Errors

Returns an error if dirty tracking cannot be enabled.

fn disable_dirty_tracking(&mut self) -> Result<(), HypervisorError>

Disables dirty page tracking.

Errors

Returns an error if dirty tracking cannot be disabled.

fn get_dirty_pages(&mut self) -> Result<Vec<DirtyPageInfo>, HypervisorError>

Gets and clears the list of dirty pages since the last call.

This resets the dirty bitmap after returning.

Errors

Returns an error if dirty pages cannot be retrieved.

fn dump_all(&self, buf: &mut [u8]) -> Result<(), HypervisorError>

Reads all guest memory into a buffer.

Errors

Returns an error if memory cannot be read.

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl GuestMemory for KvmMemory