Struct x86_64::structures::paging::mapper::MappedPageTable

pub struct MappedPageTable<'a, P: PhysToVirt> { /* fields omitted */ }

A Mapper implementation that relies on a PhysAddr to VirtAddr conversion function.

This type requires that the all physical page table frames are mapped to some virtual address. Normally, this is done by mapping the complete physical address space into the virtual address space at some offset. Other mappings between physical and virtual memory are possible too, as long as they can be calculated as an PhysAddr to VirtAddr closure.

Implementations

impl<'a, P: PhysToVirt> MappedPageTable<'a, P>

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

Creates a new MappedPageTable that uses the passed closure for converting virtual to physical addresses.

Safety

This function is unsafe because the caller must guarantee that the passed phys_to_virt closure 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(&mut self) -> &mut PageTable

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

Trait Implementations

impl<'a, P: Debug + PhysToVirt> Debug for MappedPageTable<'a, P>

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

Formats the value using the given formatter.

impl<'a, P: PhysToVirt> Mapper<Size1GiB> for MappedPageTable<'a, P>

pub 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>, 

Creates a new mapping in the page table.

pub 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.

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

Updates the flags of an existing mapping.

pub 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

pub 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

pub 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

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

Return the frame that the specified page is mapped to.

pub 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>, 

Creates a new mapping in the page table.

pub unsafe fn identity_map<A>(
    &mut self,
    frame: PhysFrame<S>,
    flags: PageTableFlags,
    frame_allocator: &mut A
) -> Result<MapperFlush<S>, MapToError<S>> where
    Self: Sized,
    A: FrameAllocator<Size4KiB>,
    S: PageSize,
    Self: Mapper<S>, 

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

impl<'a, P: PhysToVirt> Mapper<Size2MiB> for MappedPageTable<'a, P>

pub 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>, 

Creates a new mapping in the page table.

pub 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.

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

Updates the flags of an existing mapping.

pub 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

pub 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

pub 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

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

Return the frame that the specified page is mapped to.

pub 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>, 

Creates a new mapping in the page table.

pub unsafe fn identity_map<A>(
    &mut self,
    frame: PhysFrame<S>,
    flags: PageTableFlags,
    frame_allocator: &mut A
) -> Result<MapperFlush<S>, MapToError<S>> where
    Self: Sized,
    A: FrameAllocator<Size4KiB>,
    S: PageSize,
    Self: Mapper<S>, 

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

impl<'a, P: PhysToVirt> Mapper<Size4KiB> for MappedPageTable<'a, P>

pub 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>, 

Creates a new mapping in the page table.

pub 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.

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

Updates the flags of an existing mapping.

pub 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

pub 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

pub 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

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

Return the frame that the specified page is mapped to.

pub 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>, 

Creates a new mapping in the page table.

pub unsafe fn identity_map<A>(
    &mut self,
    frame: PhysFrame<S>,
    flags: PageTableFlags,
    frame_allocator: &mut A
) -> Result<MapperFlush<S>, MapToError<S>> where
    Self: Sized,
    A: FrameAllocator<Size4KiB>,
    S: PageSize,
    Self: Mapper<S>, 

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

impl<'a, P: PhysToVirt> MapperAllSizes for MappedPageTable<'a, P>

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

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

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

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