Struct KVirtArea

pub struct KVirtArea {
    range: Range<Vaddr>,
}

Kernel virtual area.

A kernel virtual area manages a range of memory in VMALLOC_VADDR_RANGE. It can map a portion or the entirety of its virtual memory pages to physical memory, whether tracked with metadata or not.

It is the caller’s responsibility to ensure TLB coherence before using the mapped virtual address on a certain CPU.

Fields

range: Range<Vaddr>

Implementations

impl KVirtArea

pub fn start(&self) -> Vaddr

pub fn end(&self) -> Vaddr

pub fn range(&self) -> Range<Vaddr>

pub fn map_frames<T: AnyFrameMeta>( area_size: usize, map_offset: usize, frames: impl Iterator<Item = Frame<T>>, prop: PageProperty, ) -> Self

Create a kernel virtual area and map tracked pages into it.

The created virtual area will have a size of area_size, and the pages will be mapped starting from map_offset in the area.

Panics

This function panics if

• the area size is not a multiple of PAGE_SIZE;
• the map offset is not aligned to PAGE_SIZE;
• the map offset plus the size of the pages exceeds the area size.

pub unsafe fn map_untracked_frames( area_size: usize, map_offset: usize, pa_range: Range<Paddr>, prop: PageProperty, ) -> Self

Creates a kernel virtual area and maps untracked frames into it.

The created virtual area will have a size of area_size, and the physical addresses will be mapped starting from map_offset in the area.

You can provide a 0..0 physical range to create a virtual area without mapping any physical memory.

Panics

This function panics if

• the area size is not a multiple of PAGE_SIZE;
• the map offset is not aligned to PAGE_SIZE;
• the provided physical range is not aligned to PAGE_SIZE;
• the map offset plus the length of the physical range exceeds the area size;
• the provided physical range contains tracked physical addresses.

• The physical addresses within pa_range should be untracked.

Trait Implementations

impl Debug for KVirtArea

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for KVirtArea

fn drop(&mut self)

Executes the destructor for this type.