Struct GlobalAllocator 

pub struct GlobalAllocator { /* private fields */ }

The global allocator used by ArceOS for axvisor.

This is an adapter around the buddy_slab_allocator::GlobalAllocator that provides compatibility with the original axalloc API and address translation support.

Implementations

impl GlobalAllocator

pub const fn new() -> Self

Creates an empty GlobalAllocator.

pub const fn name(&self) -> &'static str

Returns the name of the allocator.

pub fn init(&self, start_vaddr: usize, size: usize)

Initializes the allocator with the given region.

pub fn set_addr_translator(&self, translator: &'static dyn AddrTranslator)

Set the address translator for the allocator.

pub fn add_memory(&self, start_vaddr: usize, size: usize) -> AllocResult

Add the given region to the allocator.

pub fn alloc(&self, layout: Layout) -> AllocResult<NonNull<u8>>

Allocate arbitrary number of bytes. Returns the left bound of the allocated region.

pub fn dealloc(&self, pos: NonNull<u8>, layout: Layout)

Gives back the allocated region to the byte allocator.

pub fn alloc_pages( &self, num_pages: usize, alignment: usize, kind: UsageKind, ) -> AllocResult<usize>

Allocates contiguous pages.

pub fn alloc_dma32_pages( &self, num_pages: usize, alignment: usize, kind: UsageKind, ) -> AllocResult<usize>

Allocates contiguous low-memory pages (physical address < 4GiB).

pub fn alloc_pages_at( &self, start: usize, num_pages: usize, alignment: usize, kind: UsageKind, ) -> AllocResult<usize>

Allocates contiguous pages starting from the given address.

pub fn dealloc_pages(&self, pos: usize, num_pages: usize, kind: UsageKind)

Gives back the allocated pages starts from pos to the page allocator.

pub fn used_bytes(&self) -> usize

Returns the number of allocated bytes in the byte allocator.

pub fn available_bytes(&self) -> usize

Returns the number of available bytes in the byte allocator.

pub fn used_pages(&self) -> usize

Returns the number of allocated pages in the page allocator.

pub fn available_pages(&self) -> usize

Returns the number of available pages in the page allocator.

pub fn usages(&self) -> Usages

Returns the usage statistics of the allocator.

Trait Implementations

impl Default for GlobalAllocator

fn default() -> Self

Returns the “default value” for a type.

impl GlobalAlloc for GlobalAllocator

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.