Struct MemoryManager 

pub struct MemoryManager<P>
where
    P: MemoryProvider,
{ /* private fields */ }

The memory manager handles page-level memory operations on top of a MemoryProvider.

Implementations

impl<P> MemoryManager<P>

where P: MemoryProvider,

pub fn init(provider: P) -> Self

Initializes the memory manager and allocates the header and reserved pages.

Panics

Panics if the memory provider fails to initialize.

pub const fn acl_page(&self) -> Page

Returns the ACL page number.

pub const fn schema_page(&self) -> Page

Returns the schema page.

pub const fn unclaimed_pages_page(&self) -> Page

Returns the unclaimed-pages ledger page.

pub fn last_page(&self) -> Option<Page>

Gets the last allocated page number.

pub fn pages_count(&self) -> u64

Returns the total number of pages currently backed by the provider.

Trait Implementations

impl<P> MemoryAccess for MemoryManager<P>

where P: MemoryProvider,

fn page_size(&self) -> u64

Returns the size of a single memory page.

fn grow_one_page(&mut self) -> MemoryResult<Page>

Grows the underlying memory by exactly one page and returns the freshly allocated page number.

fn zero_page(&mut self, page: Page) -> MemoryResult<()>

Zeros out an entire page. Used by MemoryAccess::unclaim_page to scrub residual data before publishing the page to the unclaimed-pages ledger.

fn read_at<D>(&mut self, page: Page, offset: PageOffset) -> MemoryResult<D>

where D: Encode,

Reads a typed value from the specified page and offset.

fn write_at<E>( &mut self, page: Page, offset: PageOffset, data: &E, ) -> MemoryResult<()>

where E: Encode,

Writes a typed value at the specified page and offset.

fn write_at_raw( &mut self, page: Page, offset: PageOffset, buf: &[u8], ) -> MemoryResult<()>

Writes raw bytes at the specified page and offset, bypassing alignment and encoding checks.

fn zero<E>( &mut self, page: Page, offset: PageOffset, data: &E, ) -> MemoryResult<()>

where E: Encode,

Zeros out the region occupied by data at the specified page and offset.

fn zero_raw( &mut self, page: Page, offset: PageOffset, len: PageOffset, ) -> MemoryResult<()>

Zeros out len raw bytes at the specified page and offset.

fn read_at_raw( &mut self, page: Page, offset: PageOffset, buf: &mut [u8], ) -> MemoryResult<usize>

Reads raw bytes into buf at the specified page and offset.

fn claim_page(&mut self) -> MemoryResult<Page>

Hands out a page for use by a caller.

fn unclaim_page(&mut self, page: Page) -> MemoryResult<()>

Returns page to the unclaimed-pages ledger so it can be reused by a future MemoryAccess::claim_page call.