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 fn valid_bits(&self) -> usize

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

pub fn map(&mut self, config: &MapConfig) -> 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_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.

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

fn addr(&self) -> PhysAddr

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

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