Struct x86_64::structures::paging::mapper::OffsetPageTable

pub struct OffsetPageTable<'a> { /* private fields */ }

Available on 64-bit only.

A Mapper implementation that requires that the complete physically memory is mapped at some offset in the virtual address space.

Implementations

impl<'a> OffsetPageTable<'a>

pub unsafe fn new( level_4_table: &'a mut PageTable, phys_offset: VirtAddr ) -> Self

Creates a new OffsetPageTable that uses the given offset for converting virtual to physical addresses.

The complete physical memory must be mapped in the virtual address space starting at address phys_offset. This means that for example physical address 0x5000 can be accessed through virtual address phys_offset + 0x5000. This mapping is required because the mapper needs to access page tables, which are not mapped into the virtual address space by default.

Safety

This function is unsafe because the caller must guarantee that the passed phys_offset is correct. Also, the passed level_4_table must point to the level 4 page table of a valid page table hierarchy. Otherwise this function might break memory safety, e.g. by writing to an illegal memory location.

pub fn level_4_table(&self) -> &PageTable

Returns an immutable reference to the wrapped level 4 PageTable instance.

pub fn level_4_table_mut(&mut self) -> &mut PageTable

Returns a mutable reference to the wrapped level 4 PageTable instance.

pub fn phys_offset(&self) -> VirtAddr

Returns the offset used for converting virtual to physical addresses.

Trait Implementations

impl<'a> CleanUp for OffsetPageTable<'a>

unsafe fn clean_up<D>(&mut self, frame_deallocator: &mut D)

where D: FrameDeallocator<Size4KiB>,

Remove all empty P1-P3 tables

unsafe fn clean_up_addr_range<D>( &mut self, range: PageRangeInclusive, frame_deallocator: &mut D )

where D: FrameDeallocator<Size4KiB>,

Remove all empty P1-P3 tables in a certain range

impl<'a> Debug for OffsetPageTable<'a>

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

Formats the value using the given formatter.

impl<'a> Mapper<Size1GiB> for OffsetPageTable<'a>

unsafe fn map_to_with_table_flags<A>( &mut self, page: Page<Size1GiB>, frame: PhysFrame<Size1GiB>, flags: PageTableFlags, parent_table_flags: PageTableFlags, allocator: &mut A ) -> Result<MapperFlush<Size1GiB>, MapToError<Size1GiB>>

where A: FrameAllocator<Size4KiB> + ?Sized,

Creates a new mapping in the page table.

fn unmap( &mut self, page: Page<Size1GiB> ) -> Result<(PhysFrame<Size1GiB>, MapperFlush<Size1GiB>), UnmapError>

Removes a mapping from the page table and returns the frame that used to be mapped.

unsafe fn update_flags( &mut self, page: Page<Size1GiB>, flags: PageTableFlags ) -> Result<MapperFlush<Size1GiB>, FlagUpdateError>

Updates the flags of an existing mapping.

unsafe fn set_flags_p4_entry( &mut self, page: Page<Size1GiB>, flags: PageTableFlags ) -> Result<MapperFlushAll, FlagUpdateError>

Set the flags of an existing page level 4 table entry

unsafe fn set_flags_p3_entry( &mut self, page: Page<Size1GiB>, flags: PageTableFlags ) -> Result<MapperFlushAll, FlagUpdateError>

Set the flags of an existing page table level 3 entry

unsafe fn set_flags_p2_entry( &mut self, page: Page<Size1GiB>, flags: PageTableFlags ) -> Result<MapperFlushAll, FlagUpdateError>

Set the flags of an existing page table level 2 entry

fn translate_page( &self, page: Page<Size1GiB> ) -> Result<PhysFrame<Size1GiB>, TranslateError>

Return the frame that the specified page is mapped to.

unsafe fn map_to<A>( &mut self, page: Page<S>, frame: PhysFrame<S>, flags: PageTableFlags, frame_allocator: &mut A ) -> Result<MapperFlush<S>, MapToError<S>>

where Self: Sized, A: FrameAllocator<Size4KiB> + ?Sized,

Creates a new mapping in the page table.

unsafe fn identity_map<A>( &mut self, frame: PhysFrame<S>, flags: PageTableFlags, frame_allocator: &mut A ) -> Result<MapperFlush<S>, MapToError<S>>

where Self: Sized + Mapper<S>, A: FrameAllocator<Size4KiB> + ?Sized, S: PageSize,

Maps the given frame to the virtual page with the same address.

impl<'a> Mapper<Size2MiB> for OffsetPageTable<'a>

unsafe fn map_to_with_table_flags<A>( &mut self, page: Page<Size2MiB>, frame: PhysFrame<Size2MiB>, flags: PageTableFlags, parent_table_flags: PageTableFlags, allocator: &mut A ) -> Result<MapperFlush<Size2MiB>, MapToError<Size2MiB>>

where A: FrameAllocator<Size4KiB> + ?Sized,

Creates a new mapping in the page table.

fn unmap( &mut self, page: Page<Size2MiB> ) -> Result<(PhysFrame<Size2MiB>, MapperFlush<Size2MiB>), UnmapError>

Removes a mapping from the page table and returns the frame that used to be mapped.

unsafe fn update_flags( &mut self, page: Page<Size2MiB>, flags: PageTableFlags ) -> Result<MapperFlush<Size2MiB>, FlagUpdateError>

Updates the flags of an existing mapping.

unsafe fn set_flags_p4_entry( &mut self, page: Page<Size2MiB>, flags: PageTableFlags ) -> Result<MapperFlushAll, FlagUpdateError>

Set the flags of an existing page level 4 table entry

unsafe fn set_flags_p3_entry( &mut self, page: Page<Size2MiB>, flags: PageTableFlags ) -> Result<MapperFlushAll, FlagUpdateError>

Set the flags of an existing page table level 3 entry

unsafe fn set_flags_p2_entry( &mut self, page: Page<Size2MiB>, flags: PageTableFlags ) -> Result<MapperFlushAll, FlagUpdateError>

Set the flags of an existing page table level 2 entry

fn translate_page( &self, page: Page<Size2MiB> ) -> Result<PhysFrame<Size2MiB>, TranslateError>

Return the frame that the specified page is mapped to.

unsafe fn map_to<A>( &mut self, page: Page<S>, frame: PhysFrame<S>, flags: PageTableFlags, frame_allocator: &mut A ) -> Result<MapperFlush<S>, MapToError<S>>

where Self: Sized, A: FrameAllocator<Size4KiB> + ?Sized,

Creates a new mapping in the page table.

unsafe fn identity_map<A>( &mut self, frame: PhysFrame<S>, flags: PageTableFlags, frame_allocator: &mut A ) -> Result<MapperFlush<S>, MapToError<S>>

where Self: Sized + Mapper<S>, A: FrameAllocator<Size4KiB> + ?Sized, S: PageSize,

Maps the given frame to the virtual page with the same address.

impl<'a> Mapper<Size4KiB> for OffsetPageTable<'a>

unsafe fn map_to_with_table_flags<A>( &mut self, page: Page<Size4KiB>, frame: PhysFrame<Size4KiB>, flags: PageTableFlags, parent_table_flags: PageTableFlags, allocator: &mut A ) -> Result<MapperFlush<Size4KiB>, MapToError<Size4KiB>>

where A: FrameAllocator<Size4KiB> + ?Sized,

Creates a new mapping in the page table.

fn unmap( &mut self, page: Page<Size4KiB> ) -> Result<(PhysFrame<Size4KiB>, MapperFlush<Size4KiB>), UnmapError>

Removes a mapping from the page table and returns the frame that used to be mapped.

unsafe fn update_flags( &mut self, page: Page<Size4KiB>, flags: PageTableFlags ) -> Result<MapperFlush<Size4KiB>, FlagUpdateError>

Updates the flags of an existing mapping.

unsafe fn set_flags_p4_entry( &mut self, page: Page<Size4KiB>, flags: PageTableFlags ) -> Result<MapperFlushAll, FlagUpdateError>

Set the flags of an existing page level 4 table entry

unsafe fn set_flags_p3_entry( &mut self, page: Page<Size4KiB>, flags: PageTableFlags ) -> Result<MapperFlushAll, FlagUpdateError>

Set the flags of an existing page table level 3 entry

unsafe fn set_flags_p2_entry( &mut self, page: Page<Size4KiB>, flags: PageTableFlags ) -> Result<MapperFlushAll, FlagUpdateError>

Set the flags of an existing page table level 2 entry

fn translate_page( &self, page: Page<Size4KiB> ) -> Result<PhysFrame<Size4KiB>, TranslateError>

Return the frame that the specified page is mapped to.

unsafe fn map_to<A>( &mut self, page: Page<S>, frame: PhysFrame<S>, flags: PageTableFlags, frame_allocator: &mut A ) -> Result<MapperFlush<S>, MapToError<S>>

where Self: Sized, A: FrameAllocator<Size4KiB> + ?Sized,

Creates a new mapping in the page table.

unsafe fn identity_map<A>( &mut self, frame: PhysFrame<S>, flags: PageTableFlags, frame_allocator: &mut A ) -> Result<MapperFlush<S>, MapToError<S>>

where Self: Sized + Mapper<S>, A: FrameAllocator<Size4KiB> + ?Sized, S: PageSize,

Maps the given frame to the virtual page with the same address.

impl<'a> Translate for OffsetPageTable<'a>

fn translate(&self, addr: VirtAddr) -> TranslateResult

Return the frame that the given virtual address is mapped to and the offset within that frame.

fn translate_addr(&self, addr: VirtAddr) -> Option<PhysAddr>

Translates the given virtual address to the physical address that it maps to.