Struct PageTable 

pub struct PageTable<T: TableMeta, A: FrameAllocator> { /* private fields */ }

Implementations

impl<T: TableMeta, A: FrameAllocator> PageTable<T, A>

pub const VALID_BITS: usize = Frame<T, A>::PT_VALID_BITS

pub fn new(allocator: A) -> PagingResult<Self>

创建一个新的页表

pub const fn root_paddr(&self) -> PhysAddr

pub fn clone_missing_root_entries_from( &mut self, other: &PageTableRef<T, A>, start_vaddr: VirtAddr, size: usize, ) -> PagingResult

Deep-copies source root entries that are absent from this page table.

Leaf mappings keep referring to the same physical memory, while every copied intermediate page-table frame is independently owned by this page table. Existing destination root entries are left unchanged.

If allocation fails, entries copied before the failure remain installed and are reclaimed normally when this page table is dropped.

Errors

Returns an error if the range overflows or wraps around the root table, or if an intermediate page-table frame cannot be allocated.

Methods from Deref<Target = PageTableRef<T, A>>

pub fn map_page( &mut self, vaddr: VirtAddr, paddr: PhysAddr, page_size: usize, config: PteConfigOf<T>, ) -> PagingResult

Maps one page with the requested page size.

pub fn map_region( &mut self, start_vaddr: VirtAddr, get_paddr: impl Fn(VirtAddr) -> PhysAddr, size: usize, config: PteConfigOf<T>, allow_huge: bool, ) -> PagingResult

Maps a contiguous virtual region, choosing large pages when possible. Mappings installed by this call are rolled back if a later page fails. TLB invalidation is deferred and batched until the region has been updated.

pub fn unmap_page( &mut self, vaddr: VirtAddr, ) -> PagingResult<(PhysAddr, PteConfigOf<T>, usize)>

Unmaps one page and returns its physical address, flags, and page size.

pub fn protect_page( &mut self, vaddr: VirtAddr, config: PteConfigOf<T>, ) -> PagingResult<usize>

Changes one existing mapping’s flags and returns its page size.

pub fn protect_region( &mut self, start_vaddr: VirtAddr, size: usize, config: PteConfigOf<T>, ) -> PagingResult

Changes flags for a region. Unmapped base pages are skipped.

pub fn remap_page( &mut self, vaddr: VirtAddr, paddr: PhysAddr, config: PteConfigOf<T>, ) -> PagingResult<usize>

Remaps one existing mapping and returns its page size.

pub fn query( &self, vaddr: VirtAddr, ) -> PagingResult<(PhysAddr, PteConfigOf<T>, usize)>

Queries one mapping and returns the translated physical address, flags, and page size.

pub fn map(&mut self, config: &MapConfig<PteConfigOf<T>>) -> PagingResult

映射虚拟地址范围到物理地址范围

pub fn unmap(&mut self, start_vaddr: VirtAddr, size: usize) -> PagingResult<()>

取消映射虚拟地址范围

参数

• start_vaddr: 要取消映射的起始虚拟地址
• size: 要取消映射的大小（字节）

返回值

• Ok(()): 取消映射成功
• Err(PagingError): 取消映射失败

行为

• 清除指定虚拟地址范围内的所有页表项
• 自动回收空的子页表帧
• 支持大页和普通页面的取消映射
• 根据配置刷新TLB

pub fn unmap_with_config(&mut self, config: &UnmapConfig) -> PagingResult<()>

使用配置对象取消映射

pub fn walk_all(&self, config: WalkConfig) -> PageTableWalker<'_, T, A>

创建页表遍历迭代器

pub fn walk( &self, start_vaddr: VirtAddr, end_vaddr: VirtAddr, ) -> impl Iterator<Item = PteInfo<T::P>> + '_

pub fn walk_valid(&self) -> impl Iterator<Item = PteInfo<T::P>> + '_

遍历所有有效的最终映射页表项（过滤掉无效项和中间级别的页表指针）

pub unsafe fn deallocate(&mut self)

释放页表占用的所有页表帧

与destroy()不同，这个方法保留PageTable结构， 但释放所有关联的页表帧。调用后PageTable不再可用。

释放行为：

• 释放所有页表帧
• 清除所有页表项（设为invalid）
• 不释放映射的物理页（数据页/大页）

Safety

调用者必须确保：

• 没有其他代码在访问这个页表
• 没有CPU正在使用这个页表进行地址翻译

pub fn deallocate_range( &mut self, start_vaddr: VirtAddr, end_vaddr: VirtAddr, ) -> PagingResult

释放页表中的指定映射区域

释放指定虚拟地址范围内的所有页表项和子页表帧 在释放前将相关PTE设为invalid

pub fn translate(&self, vaddr: VirtAddr) -> PagingResult<(PhysAddr, T::P)>

通过虚拟地址查询页表项

参数

• vaddr: 要查询的虚拟地址

返回值

• Ok(T::P): 找到的页表项，包含物理地址信息
• Err(PagingError): 查询失败，原因可能包括：
  • 地址未映射
  • 页表项无效
  • 页表层次结构错误

pub fn translate_with_level( &self, vaddr: VirtAddr, ) -> PagingResult<(PhysAddr, T::P, usize)>

Translates a virtual address and returns the matched PTE level.

pub fn translate_phys(&self, vaddr: VirtAddr) -> PagingResult<PhysAddr>

通过虚拟地址查询物理地址（便利方法）

参数

• vaddr: 要查询的虚拟地址

返回值

• Ok(PhysAddr): 找到的物理地址
• Err(PagingError): 查询失败

pub fn is_mapped(&self, vaddr: VirtAddr) -> bool

检查虚拟地址是否已映射

这是一个便利方法，用于快速检查地址是否已映射而不需要获取页表项

参数

• vaddr: 要检查的虚拟地址

返回值

• true: 地址已映射
• false: 地址未映射

pub fn root_paddr(&self) -> PhysAddr

获取页表的根帧物理地址

Trait Implementations

impl<T: TableMeta, A: FrameAllocator> Deref for PageTable<T, A>

type Target = PageTableRef<T, A>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: TableMeta, A: FrameAllocator> DerefMut for PageTable<T, A>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T: TableMeta, A: FrameAllocator> Drop for PageTable<T, A>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<T: TableMeta, A: FrameAllocator> PageTableOp for PageTable<T, A>

type PteConfig = <<T as TableMeta>::P as PageTableEntry>::PteConfig

fn addr(&self) -> PhysAddr

fn map(&mut self, config: &MapConfig<Self::PteConfig>) -> PagingResult

fn unmap(&mut self, virt_start: VirtAddr, size: usize) -> PagingResult