Struct PageTableRef 

pub struct PageTableRef<T, A>
where
    T: TableMeta,
    A: FrameAllocator,
{
    pub root: Frame<T, A>,
}

Fields

root: Frame<T, A>

Implementations

impl<T, A> PageTableRef<T, A>

where T: TableMeta, A: FrameAllocator,

pub unsafe fn new(allocator: A) -> Result<PageTableRef<T, A>, PagingError>

创建一个新的页表

Safety

调用者必须确保提供的FrameAllocator是有效的，并且在页表生命周期内保持有效

pub fn from_paddr(paddr: PhysAddr, allocator: A) -> PageTableRef<T, A>

pub fn map_page( &mut self, vaddr: VirtAddr, paddr: PhysAddr, page_size: usize, config: <<T as TableMeta>::P as PageTableEntry>::PteConfig, ) -> Result<(), PagingError>

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: <<T as TableMeta>::P as PageTableEntry>::PteConfig, allow_huge: bool, ) -> Result<(), PagingError>

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, ) -> Result<(PhysAddr, <<T as TableMeta>::P as PageTableEntry>::PteConfig, usize), PagingError>

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

pub fn protect_page( &mut self, vaddr: VirtAddr, config: <<T as TableMeta>::P as PageTableEntry>::PteConfig, ) -> Result<usize, PagingError>

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

pub fn protect_region( &mut self, start_vaddr: VirtAddr, size: usize, config: <<T as TableMeta>::P as PageTableEntry>::PteConfig, ) -> Result<(), PagingError>

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

pub fn remap_page( &mut self, vaddr: VirtAddr, paddr: PhysAddr, config: <<T as TableMeta>::P as PageTableEntry>::PteConfig, ) -> Result<usize, PagingError>

Remaps one existing mapping and returns its page size.

pub fn query( &self, vaddr: VirtAddr, ) -> Result<(PhysAddr, <<T as TableMeta>::P as PageTableEntry>::PteConfig, usize), PagingError>

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

pub fn map( &mut self, config: &MapConfig<<<T as TableMeta>::P as PageTableEntry>::PteConfig>, ) -> Result<(), PagingError>

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

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

取消映射虚拟地址范围

参数

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

返回值

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

行为

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

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

使用配置对象取消映射

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 as TableMeta>::P>>

pub fn walk_valid(&self) -> impl Iterator<Item = PteInfo<<T as TableMeta>::P>>

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

pub const fn page_size() -> usize

pub const fn table_levels() -> usize

pub const fn valid_bits() -> usize

pub unsafe fn destroy(self)

销毁整个页表结构

此方法会：

1. 递归释放根帧及所有子页表帧
2. 清除所有页表项（设为invalid）
3. 不释放映射的物理页（数据页/大页）

Safety

调用者必须确保：

• 没有其他代码在访问这个页表
• 没有CPU正在使用这个页表进行地址翻译
• 调用后不再使用这个PageTable实例

pub unsafe fn deallocate(&mut self)

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

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

释放行为：

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

Safety

调用者必须确保：

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

pub fn deallocate_range( &mut self, start_vaddr: VirtAddr, end_vaddr: VirtAddr, ) -> Result<(), PagingError>

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

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

pub fn translate( &self, vaddr: VirtAddr, ) -> Result<(PhysAddr, <T as TableMeta>::P), PagingError>

通过虚拟地址查询页表项

参数

• vaddr: 要查询的虚拟地址

返回值

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

pub fn translate_with_level( &self, vaddr: VirtAddr, ) -> Result<(PhysAddr, <T as TableMeta>::P, usize), PagingError>

Translates a virtual address and returns the matched PTE level.

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

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

参数

• 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, A> Clone for PageTableRef<T, A>

where T: Clone + TableMeta, A: Clone + FrameAllocator,

fn clone(&self) -> PageTableRef<T, A>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T, A> Copy for PageTableRef<T, A>

where T: Copy + TableMeta, A: Copy + FrameAllocator,

impl<T, A> Debug for PageTableRef<T, A>

where T: TableMeta, A: FrameAllocator, <T as TableMeta>::P: Debug,

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

Formats the value using the given formatter.

impl<T, A> PageTableOp for PageTableRef<T, A>

where T: TableMeta, A: FrameAllocator,

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

fn addr(&self) -> PhysAddr

fn map( &mut self, config: &MapConfig<<PageTableRef<T, A> as PageTableOp>::PteConfig>, ) -> Result<(), PagingError>

fn unmap( &mut self, virt_start: VirtAddr, size: usize, ) -> Result<(), PagingError>