Struct RegionManager 

pub struct RegionManager<const MAX: usize> { /* private fields */ }

Manages a fixed-capacity table of owned memory regions.

MAX is the compile-time upper bound on the number of regions.

Implementations

impl<const MAX: usize> RegionManager<MAX>

pub const fn new() -> Self

Create a new empty region manager.

pub const fn count(&self) -> usize

Return the number of active regions.

pub const fn capacity(&self) -> usize

Return the maximum capacity.

pub fn create(&mut self, config: RegionConfig) -> RvmResult<OwnedRegionId>

Create a new memory region from the given configuration.

Validates alignment, non-zero page count, and overlap with existing regions in the same partition.

Errors

Returns RvmError::AlignmentError if addresses are not page-aligned. Returns RvmError::ResourceLimitExceeded if page count is zero or the manager is at capacity. Returns RvmError::MemoryOverlap if the region overlaps an existing region in the same partition.

pub fn create_auto_id( &mut self, owner: PartitionId, guest_base: GuestPhysAddr, host_base: PhysAddr, page_count: u32, tier: Tier, permissions: MemoryPermissions, ) -> RvmResult<OwnedRegionId>

Allocate a fresh OwnedRegionId and create the region.

Errors

See RegionManager::create for error conditions.

pub fn destroy(&mut self, region_id: OwnedRegionId) -> RvmResult<OwnedRegion>

Destroy a region, freeing its slot.

Errors

Returns RvmError::PartitionNotFound if the region does not exist.

pub fn transfer( &mut self, region_id: OwnedRegionId, new_owner: PartitionId, ) -> RvmResult<()>

Transfer ownership of a region to a new partition.

This conceptually moves the region: the old owner loses access and the new owner gains it. The guest-physical mapping remains the same (the new partition sees the region at the same guest address).

Errors

Returns RvmError::PartitionNotFound if the region does not exist. Returns RvmError::MemoryOverlap if the new owner already has a region at the same guest address range.

pub fn get(&self, region_id: OwnedRegionId) -> Option<&OwnedRegion>

Look up a region by its identifier.

pub fn get_mut(&mut self, region_id: OwnedRegionId) -> Option<&mut OwnedRegion>

Look up a region by its identifier (mutable).

pub fn translate( &self, owner: PartitionId, guest: GuestPhysAddr, ) -> Option<AddressMapping>

Translate a guest physical address to a host physical address within the given partition.

pub fn count_for_partition(&self, owner: PartitionId) -> usize

Count how many regions are owned by a given partition.

pub fn regions_for_partition( &self, owner: PartitionId, out: &mut [OwnedRegionId], ) -> usize

Iterate over the region IDs owned by a given partition. Writes matching IDs into out and returns the count written.

Trait Implementations

impl<const MAX: usize> Default for RegionManager<MAX>

fn default() -> Self

Returns the “default value” for a type.