Enum MemoryBuildError 

pub enum MemoryBuildError {
    RamTooLarge(MemorySize),
    AllocationFailed(Error),
    HugepageAllocationFailed {
        size: MemorySize,
        hugepage_size: MemorySize,
        page_count: usize,
        error: Error,
    },
    VaMapper(VaMapperError),
    RamMapping {
        range: MemoryRange,
        error: RemoteError,
    },
    RamRegionEnable {
        range: MemoryRange,
        error: RemoteError,
    },
    AliasMapWontFit,
    InvalidRamForX86,
    PrivateMemoryWithLegacy,
    PrivateMemoryWithExistingBacking,
    ThpWithoutPrivateMemory,
    ThpUnsupportedPlatform,
    HugepageSizeTooLarge(MemorySize),
    HugepagesUnsupportedPlatform,
    HostNumaNodeUnsupportedPlatform,
    HugepagesWithPrivateMemory,
    HugepagesWithExistingBacking,
    HugepagesWithLegacy,
    InvalidHugepageSize(MemorySize),
    HugepageRamSizeUnaligned {
        ram_size: MemorySize,
        hugepage_size: MemorySize,
    },
    HugepageRamRangeUnaligned {
        range: MemoryRange,
        range_size: MemorySize,
        hugepage_size: MemorySize,
    },
}

Errors creating a GuestMemoryManager.

Variants

RamTooLarge(MemorySize)

RAM too large.

AllocationFailed(Error)

Couldn’t allocate RAM.

HugepageAllocationFailed

Couldn’t allocate hugetlb-backed RAM.

Fields

size: MemorySize

Total RAM backing size.

hugepage_size: MemorySize

Requested or default hugepage size.

page_count: usize

Number of hugepages required.

error: Error

The allocation error.

VaMapper(VaMapperError)

Couldn’t allocate VA mapper.

RamMapping

Failed to map RAM into VA space.

Fields

range: MemoryRange

The GPA range that failed to map.

error: RemoteError

The mapping error.

RamRegionEnable

Failed to enable RAM region.

Fields

range: MemoryRange

The GPA range that failed.

error: RemoteError

The error.

AliasMapWontFit

Memory layout incompatible with VTL0 alias map.

InvalidRamForX86

Memory layout incompatible with x86 legacy support.

PrivateMemoryWithLegacy

Private memory is incompatible with x86 legacy support.

PrivateMemoryWithExistingBacking

Private memory is incompatible with an existing memory backing.

ThpWithoutPrivateMemory

THP requires private memory mode.

ThpUnsupportedPlatform

THP is only supported on Linux.

HugepageSizeTooLarge(MemorySize)

Hugepage size is too large.

HugepagesUnsupportedPlatform

Hugepages are only supported on Linux and Windows.

HostNumaNodeUnsupportedPlatform

Host NUMA node binding is only supported on Linux and Windows.

HugepagesWithPrivateMemory

Hugepages require shared memory mode.

HugepagesWithExistingBacking

Hugepages are incompatible with existing memory backing.

HugepagesWithLegacy

Hugepages are incompatible with x86 legacy RAM splitting.

InvalidHugepageSize(MemorySize)

Invalid hugepage size.

HugepageRamSizeUnaligned

RAM size is not aligned to the hugepage size.

Fields

ram_size: MemorySize

Total RAM backing size.

hugepage_size: MemorySize

Required hugepage alignment.

HugepageRamRangeUnaligned

A RAM range is not aligned to the hugepage size.

Fields

range: MemoryRange

The unaligned RAM range.

range_size: MemorySize

The RAM range size.

hugepage_size: MemorySize

Required hugepage alignment.

Trait Implementations

impl Debug for MemoryBuildError

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

Formats the value using the given formatter.

impl Display for MemoryBuildError

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

Formats the value using the given formatter.

impl Error for MemoryBuildError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.