Struct KernelHeap

pub struct KernelHeap {
    stage: UnsafeCell<Stage>,
    primitive_ptr: *const u8,
    primitive_end: *const u8,
}

Implementation of GlobalAlloc for objects belong to kernel space.

This allocator has 2 stages. The first stage will allocate a memory from a static buffer (AKA arena). This stage will be primary used for bootstrapping the kernel. The second stage will be activated once the required subsystems has been initialized.

The first stage is not thread safe so stage 2 must be activated before start a new CPU.

Fields

stage: UnsafeCell<Stage>

primitive_ptr: *const u8

primitive_end: *const u8

Implementations

impl KernelHeap

pub const unsafe fn new<const L: usize>(primitive: *mut [u8; L]) -> Self

Safety

The specified memory must be valid for reads and writes and it must be exclusively available to KernelHeap.

pub unsafe fn activate_stage2(&self)

Safety

This must be called by main CPU and can be called only once.

Trait Implementations

impl GlobalAlloc for KernelHeap

unsafe fn alloc(&self, layout: Layout) -> *mut u8

Allocates memory as described by the given layout.

unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout)

Deallocates the block of memory at the given ptr pointer with the given layout.

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

Behaves like alloc, but also ensures that the contents are set to zero before being returned.

unsafe fn realloc( &self, ptr: *mut u8, layout: Layout, new_size: usize, ) -> *mut u8

Shrinks or grows a block of memory to the given new_size in bytes. The block is described by the given ptr pointer and layout.

impl Send for KernelHeap

impl Sync for KernelHeap