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.

Methods

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.

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.

Trait Implementations

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

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.

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

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

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.

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

Updates the flags of an existing mapping.

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

Return the frame that the specified page is mapped to.

unsafe fn identity_map<A>(
    &mut self,
    frame: PhysFrame<S>,
    flags: PageTableFlags,
    frame_allocator: &mut A
) -> Result<MapperFlush<S>, MapToError> where
    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>

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

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.

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

Updates the flags of an existing mapping.

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

Return the frame that the specified page is mapped to.

unsafe fn identity_map<A>(
    &mut self,
    frame: PhysFrame<S>,
    flags: PageTableFlags,
    frame_allocator: &mut A
) -> Result<MapperFlush<S>, MapToError> where
    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>

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

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.

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

Updates the flags of an existing mapping.

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

Return the frame that the specified page is mapped to.

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

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

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

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

Formats the value using the given formatter.