Struct GlobalAllocator 

pub struct GlobalAllocator { /* private fields */ }

The global allocator used by ArceOS when buddy-slab is enabled.

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) -> AllocResult

Initializes the allocator with the given region.

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 < 4 GiB).

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 allocator backend.

pub fn available_bytes(&self) -> usize

Returns the number of available bytes in the allocator backend.

pub fn used_pages(&self) -> usize

Returns the number of allocated pages in the allocator backend.

pub fn available_pages(&self) -> usize

Returns the number of available pages in the allocator backend.

pub fn usages(&self) -> Usages

Returns the usage statistics of the allocator.

Trait Implementations

impl AllocatorOps for GlobalAllocator

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

Returns the allocator name.

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

Initializes the allocator with the given region.

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

Adds an extra memory region to the allocator.

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

Allocates arbitrary bytes.

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

Deallocates a prior byte allocation.

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

Allocates contiguous pages.

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

Allocates contiguous DMA32 pages.

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

Allocates contiguous pages starting from the given address.

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

Deallocates a prior page allocation.

fn used_bytes(&self) -> usize

Returns used byte count.

fn available_bytes(&self) -> usize

Returns available byte count.

fn used_pages(&self) -> usize

Returns used page count.

fn available_pages(&self) -> usize

Returns available page count.

fn usages(&self) -> Usages

Returns usage statistics.

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.