Enum vm_control::VmMemoryRequest

pub enum VmMemoryRequest {
    PrepareSharedMemoryRegion {
        alloc: Alloc,
        cache: MemCacheType,
    },
    RegisterMemory {
        source: VmMemorySource,
        dest: VmMemoryDestination,
        prot: Protection,
        cache: MemCacheType,
    },
    MmapAndRegisterMemory {
        shm: SharedMemory,
        dest: VmMemoryDestination,
        num_file_mappings: usize,
    },
    DynamicallyFreeMemoryRanges {
        ranges: Vec<(GuestAddress, u64)>,
    },
    DynamicallyReclaimMemoryRanges {
        ranges: Vec<(GuestAddress, u64)>,
    },
    BalloonTargetReached {
        size: u64,
    },
    UnregisterMemory(VmMemoryRegionId),
    IoEventRaw(IoEventUpdateRequest),
}

Variants

PrepareSharedMemoryRegion

Prepare a shared memory region to make later operations more efficient. This may be a no-op depending on underlying platform support.

Fields

alloc: Alloc

cache: MemCacheType

RegisterMemory

Register a memory to be mapped to the guest.

Fields

source: VmMemorySource

Source of the memory to register (mapped file descriptor, shared memory region, etc.)

dest: VmMemoryDestination

Where to map the memory in the guest.

prot: Protection

Whether to map the memory read only (true) or read-write (false).

cache: MemCacheType

Cache attribute for guest memory setting

MmapAndRegisterMemory

Call mmap to shm and register the memory region as a read-only guest memory. This request is followed by an array of VmMemoryFileMapping with length num_file_mappings

Fields

shm: SharedMemory

Source of the memory to register (mapped file descriptor, shared memory region, etc.)

dest: VmMemoryDestination

Where to map the memory in the guest.

num_file_mappings: usize

Length of the array of VmMemoryFileMapping that follows.

DynamicallyFreeMemoryRanges

Call hypervisor to free the given memory range.

Fields

ranges: Vec<(GuestAddress, u64)>

DynamicallyReclaimMemoryRanges

Call hypervisor to reclaim a priorly freed memory range.

Fields

ranges: Vec<(GuestAddress, u64)>

BalloonTargetReached

Balloon allocation/deallocation target reached.

Fields

size: u64

UnregisterMemory(VmMemoryRegionId)

Unregister the given memory slot that was previously registered with RegisterMemory.

IoEventRaw(IoEventUpdateRequest)

Register an eventfd with raw guest memory address.

Implementations

impl VmMemoryRequest

pub fn execute( self, tube: &Tube, vm: &mut impl Vm, sys_allocator: &mut SystemAllocator, gralloc: &mut RutabagaGralloc, iommu_client: Option<&mut VmMemoryRequestIommuClient>, region_state: &mut VmMemoryRegionState, ) -> VmMemoryResponse

Executes this request on the given Vm.

Arguments

• vm - The Vm to perform the request on.
• allocator - Used to allocate addresses.

This does not return a result, instead encapsulating the success or failure in a VmMemoryResponse with the intended purpose of sending the response back over the socket that received this VmMemoryResponse.

Trait Implementations

impl<'de> Deserialize<'de> for VmMemoryRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for VmMemoryRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.