Crate buddy_slab_allocator 

buddy-slab-allocator Memory Allocator

This crate implements a high-performance memory allocator designed for embedded and kernel environments, featuring:

• Buddy page allocator for page-level allocation
• Slab allocator for small object allocation
• Global allocator coordination
• Zero std dependency (fully #![no_std])

Features

• Buddy Page Allocator: Efficient page-level memory allocation with automatic merging
• Slab Byte Allocator: Fast small object allocation (≤2048 bytes)
• Global Allocator: Automatic selection between page and slab allocation based on size
• No_std Compatible: Fully #![no_std] for embedded/kernel use
• Optional Logging: Conditional compilation with log feature
• Memory Tracking: Detailed statistics with tracking feature

Quick Start

use buddy_slab_allocator::{GlobalAllocator, PageAllocator};
use core::alloc::Layout;

const PAGE_SIZE: usize = 0x1000;
let mut allocator = GlobalAllocator::<PAGE_SIZE>::new();

// Initialize with memory region
let heap_start = 0x8000_0000;
let heap_size = 16 * 1024 * 1024; // 16MB
allocator.init(heap_start, heap_size).unwrap();

// Allocate pages
let addr = allocator.alloc_pages(4, PAGE_SIZE).unwrap();
// Use the allocated memory...
allocator.dealloc_pages(addr, 4);

Small Object Allocation

use buddy_slab_allocator::GlobalAllocator;
use core::alloc::Layout;

const PAGE_SIZE: usize = 0x1000;
let mut allocator = GlobalAllocator::<PAGE_SIZE>::new();
allocator.init(0x8000_0000, 16 * 1024 * 1024).unwrap();

// Small allocations go through slab allocator
let layout = Layout::from_size_align(64, 8).unwrap();
let ptr = allocator.alloc(layout).unwrap();
// Use the allocated memory...
allocator.dealloc(ptr, layout);

Statistics Tracking

use buddy_slab_allocator::GlobalAllocator;

const PAGE_SIZE: usize = 0x1000;
let mut allocator = GlobalAllocator::<PAGE_SIZE>::new();
allocator.init(0x8000_0000, 16 * 1024 * 1024).unwrap();

let stats = allocator.get_stats();
println!("Total pages: {}", stats.total_pages);
println!("Used pages: {}", stats.used_pages);
println!("Free pages: {}", stats.free_pages);

Re-exports

pub use buddy::BuddyPageAllocator;

pub use buddy::DEFAULT_MAX_ORDER;

pub use buddy::MAX_ZONES;

pub use page_allocator::CompositePageAllocator;

pub use slab::slab_byte_allocator::PageAllocatorForSlab;

pub use slab::slab_byte_allocator::SizeClass;

pub use slab::slab_byte_allocator::SlabByteAllocator;

pub use global_allocator::GlobalAllocator;

Modules

buddy

Buddy page allocator module

global_allocator

Global allocator implementation.

page_allocator

Page allocator with contiguous block combination support.

slab

Slab allocator implementation.

Enums

AllocError

The error type used for allocation operations.

Constants

DEFAULT_PAGE_SIZE

Default page size for backward compatibility (4KB)

Traits

AddrTranslator

Address translator used by allocators to reason about physical addresses.

BaseAllocator

The base allocator trait inherited by other allocator traits.

ByteAllocator

Byte-granularity allocator for arbitrary-size allocations.

IdAllocator

ID allocator for managing unique identifiers (e.g., thread IDs).

PageAllocator

Page-granularity allocator for managing memory in pages.

Type Aliases

AllocResult

A Result type with AllocError as the error type.