Files
asterinas/osdk/deps/frame-allocator/src/test.rs
2025-03-14 08:37:37 +08:00

87 lines
2.8 KiB
Rust

// SPDX-License-Identifier: MPL-2.0
//! Providing test utilities and high-level test cases for the frame allocator.
use core::alloc::Layout;
use ostd::{
mm::{frame::GlobalFrameAllocator, FrameAllocOptions, Paddr, Segment, UniqueFrame, PAGE_SIZE},
prelude::ktest,
};
use super::FrameAllocator;
#[ktest]
fn frame_allocator_alloc_layout_match() {
assert_allocation_well_formed(Layout::from_size_align(PAGE_SIZE, PAGE_SIZE).unwrap());
assert_allocation_well_formed(Layout::from_size_align(PAGE_SIZE * 2, PAGE_SIZE).unwrap());
assert_allocation_well_formed(Layout::from_size_align(PAGE_SIZE * 3, PAGE_SIZE).unwrap());
assert_allocation_well_formed(Layout::from_size_align(PAGE_SIZE * 4, PAGE_SIZE).unwrap());
assert_allocation_well_formed(Layout::from_size_align(PAGE_SIZE * 2, PAGE_SIZE * 2).unwrap());
assert_allocation_well_formed(Layout::from_size_align(PAGE_SIZE * 4, PAGE_SIZE * 4).unwrap());
assert_allocation_well_formed(Layout::from_size_align(PAGE_SIZE * 8, PAGE_SIZE * 8).unwrap());
assert_allocation_well_formed(Layout::from_size_align(PAGE_SIZE * 16, PAGE_SIZE * 16).unwrap());
}
#[track_caller]
fn assert_allocation_well_formed(layout: Layout) {
let instance = FrameAllocator;
let allocated = instance.alloc(layout).unwrap();
assert_eq!(
allocated % layout.align(),
0,
"Allocation alignment mismatch"
);
for offset in (0..layout.size()).step_by(PAGE_SIZE) {
let frame = allocated + offset;
let frame = UniqueFrame::from_unused(frame, ()).unwrap_or_else(|e| {
panic!(
"Metadata not well-formed after allocation at offset {:#x}: {:#?}",
offset, e
)
});
frame.reset_as_unused();
}
instance.add_free_memory(allocated, layout.size());
}
/// A mocked memory region for testing.
///
/// All the frames in the returned memory region will be marked as used.
/// When the region is dropped, all the frames will be returned to the global
/// frame allocator. If any frame is not unused by that time, the drop will panic.
pub(crate) struct MockMemoryRegion {
addr: Paddr,
size: usize,
}
impl MockMemoryRegion {
/// Gets a memory region for testing.
pub(crate) fn alloc(size: usize) -> Self {
let seg = FrameAllocOptions::new()
.alloc_segment(size / PAGE_SIZE)
.unwrap();
let addr = seg.start_paddr();
for frame in seg {
UniqueFrame::try_from(frame).unwrap().reset_as_unused();
}
Self { addr, size }
}
/// Gets the start address of the memory region.
pub(crate) fn start_paddr(&self) -> Paddr {
self.addr
}
}
impl Drop for MockMemoryRegion {
fn drop(&mut self) {
let seg = Segment::from_unused(self.addr..self.addr + self.size, |_| ()).unwrap();
drop(seg);
}
}