Struct VirtualMemory 

pub struct VirtualMemory { /* private fields */ }

Virtual memory manager providing unified access to tiered storage

Implementations

impl VirtualMemory

pub fn new(config: VirtualMemoryConfig) -> Result<Self, VirtualMemoryError>

Create a new virtual memory manager

pub fn allocate( &self, size: usize, home_tier: MemoryTier, ) -> Result<VMemHandle, VirtualMemoryError>

Allocate virtual memory

The home_tier specifies where data is persisted. For Disk tier, data is written to disk; for Host tier, data stays in RAM.

pub fn free(&self, handle: &VMemHandle) -> Result<(), VirtualMemoryError>

Free a virtual memory allocation

pub fn write( &self, handle: &VMemHandle, data: &[u8], ) -> Result<(), VirtualMemoryError>

Write data to a virtual memory allocation

pub fn read(&self, handle: &VMemHandle) -> Result<Vec<u8>, VirtualMemoryError>

Read data from a virtual memory allocation

pub fn migrate( &self, handle: &VMemHandle, target_tier: MemoryTier, ) -> Result<(), VirtualMemoryError>

Migrate data to a different tier

pub fn pin(&self, handle: &VMemHandle) -> Result<(), VirtualMemoryError>

Pin an allocation (prevent eviction)

pub fn unpin(&self, handle: &VMemHandle) -> Result<(), VirtualMemoryError>

Unpin an allocation (allow eviction)

pub fn stats(&self) -> VirtualMemoryStats

Get statistics about virtual memory usage

pub fn flush(&self) -> Result<(), VirtualMemoryError>

Flush all dirty allocations to their home tier