Struct FrameAllocator 

pub struct FrameAllocator { /* private fields */ }

NUMA-aware hybrid frame allocator

Implementations

impl FrameAllocator

pub const fn new() -> Self

Create a new frame allocator

pub fn add_reserved_region(&self, region: ReservedRegion) -> Result<()>

Add a reserved memory region

pub fn is_reserved(&self, start: FrameNumber, count: usize) -> bool

Check if a frame range is reserved

pub fn mark_standard_reserved_regions(&self)

Mark standard reserved regions (e.g., BIOS, kernel, boot data)

pub fn init_numa_node( &mut self, node: usize, start_frame: FrameNumber, frame_count: usize, ) -> Result<()>

Initialize a NUMA node with memory range

pub fn allocate_frames( &self, count: usize, numa_node: Option<usize>, ) -> Result<FrameNumber>

Allocate frames from a specific NUMA node

pub fn allocate_frames_in_zone( &self, count: usize, numa_node: Option<usize>, zone: Option<MemoryZone>, ) -> Result<FrameNumber>

Allocate frames from a specific NUMA node and memory zone

pub fn mark_frame_used(&self, frame: FrameNumber) -> Result<()>

Mark a specific physical frame as used (reserved) so it won’t be allocated. Used to protect boot page table frames from being overwritten by the frame allocator.

pub fn free_frames(&self, frame: FrameNumber, count: usize) -> Result<()>

Free frames back to the allocator

pub fn get_stats(&self) -> FrameAllocatorStats

Get allocator statistics

pub fn allocate_frame_raii(&'static self) -> Result<FrameGuard>

Allocate a single frame with RAII guard

pub fn allocate_frames_raii(&'static self, count: usize) -> Result<FramesGuard>

Allocate multiple frames with RAII guard

pub fn allocate_frame_raii_numa( &'static self, numa_node: usize, ) -> Result<FrameGuard>

Allocate frame from specific NUMA node with RAII guard

pub unsafe fn free_frame(&self, frame: PhysicalFrame)

Free a frame (used by RAII guards)

Safety

The caller must ensure that:

• The frame was previously allocated by this allocator
• The frame is not currently in use
• The frame will not be used after this call

pub fn deallocate_frame(&self, frame: PhysicalAddress)

Deallocate a single frame (wrapper for free_frames)

Trait Implementations

impl Default for FrameAllocator

fn default() -> Self

Returns the “default value” for a type.