Struct KvmMemory 

pub struct KvmMemory { /* private fields */ }

Guest memory implementation for Linux KVM.

This manages the guest physical address space using mmap’d memory that is registered with KVM via KVM_SET_USER_MEMORY_REGION.

Implementations

impl KvmMemory

pub fn new(size: u64) -> Result<Self, HypervisorError>

Creates a new guest memory region.

Errors

Returns an error if memory allocation fails.

pub fn host_address(&self) -> *mut u8

Returns the host address of the base memory region.

This is used when registering memory with KVM.

pub fn add_region( &self, guest_addr: GuestAddress, size: u64, ) -> Result<*mut u8, HypervisorError>

Adds an additional memory region.

Errors

Returns an error if the region overlaps with existing regions or memory allocation fails.

pub unsafe fn add_external_region( &self, guest_addr: GuestAddress, host_addr: *mut u8, size: u64, read_only: bool, ) -> Result<(), HypervisorError>

Adds an externally allocated memory region.

The caller is responsible for ensuring the memory remains valid for the lifetime of this object.

Safety

The host_addr must point to valid memory of at least size bytes that will remain valid for the lifetime of this KvmMemory.

pub fn attach_vm_fd(&self, vm_fd: RawFd)

Attaches the KVM VM fd for dirty logging.

pub fn register_slot( &self, slot: u32, guest_phys_addr: u64, size: u64, userspace_addr: u64, flags: u32, ) -> Result<(), HypervisorError>

Registers a memory slot for dirty logging.

Errors

Returns an error if the slot list cannot be updated.

pub fn unregister_slot(&self, slot: u32) -> Result<(), HypervisorError>

Unregisters a memory slot.

Errors

Returns an error if the slot list cannot be updated.

pub fn set_dirty_tracking_enabled(&self, enabled: bool)

Updates the dirty tracking enabled flag from external callers.

pub fn regions(&self) -> Result<Vec<MemoryRegion>, HypervisorError>

Returns an iterator over all memory regions.

pub fn write_obj<T: Copy>( &self, addr: GuestAddress, val: &T, ) -> Result<(), HypervisorError>

Writes a value to guest memory at the specified address.

pub fn read_obj<T: Copy + Default>( &self, addr: GuestAddress, ) -> Result<T, HypervisorError>

Reads a value from guest memory at the specified address.

pub fn memset( &self, addr: GuestAddress, val: u8, len: usize, ) -> Result<(), HypervisorError>

Fills a range of guest memory with a byte value.

Trait Implementations

impl Drop for KvmMemory

fn drop(&mut self)

Executes the destructor for this type.

impl GuestMemory for KvmMemory

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

Reads bytes from guest memory.

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

Writes bytes to guest memory.

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

Gets the host virtual address for a guest physical address.

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.

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

Disables dirty page tracking.

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

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

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

Reads all guest memory into a buffer.

impl Send for KvmMemory

impl Sync for KvmMemory