Struct MemoryConfig 

pub struct MemoryConfig {
    pub startup_bytes: u64,
    pub dynamic_memory_range: Option<(u64, u64)>,
    pub numa_mem_sizes: Option<Vec<u64>>,
    pub private_memory: Option<bool>,
    pub transparent_hugepages: bool,
}

Common memory configuration information for the VM.

Fields

startup_bytes: u64

Specifies the amount of memory, in bytes, to assign to the virtual machine.

dynamic_memory_range: Option<(u64, u64)>

Specifies the minimum and maximum amount of dynamic memory, in bytes.

Dynamic memory will be disabled if this is None.

numa_mem_sizes: Option<Vec<u64>>

Per-NUMA-node memory sizes. When set, RAM is distributed across vNUMA nodes instead of assigning all RAM to node 0.

private_memory: Option<bool>

Whether to back guest RAM with private anonymous memory rather than a shared (file/memfd-backed) memory section.

• None (the default) uses private memory whenever the configuration allows it, falling back to shared memory otherwise. Private anonymous memory is cheaper to set up and eligible for Transparent Huge Pages, so it is preferred for performance; this lets each VM get the best backing for its firmware without the test having to know the details.
• Some(true) explicitly requires private memory. This is an error if the configuration is incompatible with private memory (OpenHCL, which shares VTL0 RAM with VTL2 via a remote mapper, and PCAT/Gen1, which relies on x86 legacy support, both require shared memory), rather than silently downgrading to shared.
• Some(false) explicitly requires shared memory, for tests that need the guest RAM backing to be shareable with another process, such as vhost-user backends.

Only applies to the OpenVMM backend; ignored by Hyper-V.

transparent_hugepages: bool

Mark guest RAM as eligible for Transparent Huge Pages (THP), improving performance for large allocations.

Defaults to true. Applies to private anonymous guest RAM and to shared memfd-backed RAM, on Linux (via madvise) and on Windows (via soft large pages). It has no effect on explicit hugetlb/large-page backings (see with_hugepages), which are already huge.

Only applies to the OpenVMM backend; ignored by Hyper-V.

Trait Implementations

impl Debug for MemoryConfig

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

Formats the value using the given formatter.

impl Default for MemoryConfig

fn default() -> Self

Returns the “default value” for a type.