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,
    },
    DynamicallyFreeMemoryRange {
        guest_address: GuestAddress,
        size: u64,
    },
    DynamicallyReclaimMemoryRange {
        guest_address: GuestAddress,
        size: u64,
    },
    BalloonTargetReached {
        size: u64,
    },
    UnregisterMemory(VmMemoryRegionId),
    IoEventWithAlloc {
        evt: Event,
        allocation: Alloc,
        offset: u64,
        datamatch: Datamatch,
        register: bool,
    },
    IoEventRaw(IoEventUpdateRequest),
}

Variants

PrepareSharedMemoryRegion

Fields

alloc: Alloc

cache: MemCacheType

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

RegisterMemory

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

Register a memory to be mapped to the guest.

MmapAndRegisterMemory

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.

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

DynamicallyFreeMemoryRange

Fields

guest_address: GuestAddress

size: u64

Call hypervisor to free the given memory range.

DynamicallyReclaimMemoryRange

Fields

guest_address: GuestAddress

size: u64

Call hypervisor to reclaim a priorly freed memory range.

BalloonTargetReached

Fields

size: u64

Balloon allocation/deallocation target reached.

UnregisterMemory(VmMemoryRegionId)

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

IoEventWithAlloc

Fields

evt: Event

allocation: Alloc

offset: u64

datamatch: Datamatch

register: bool

Register an ioeventfd by looking up using Alloc info.

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.