Struct IoPageTable 

pub struct IoPageTable<F: IoPageTableFmt> { /* private fields */ }

An io page table using a specific format.

Invariants

The pointer references a valid io page table.

Implementations

impl<F: IoPageTableFmt> IoPageTable<F>

pub fn new( dev: &Device<Bound>, config: Config, ) -> impl PinInit<Devres<IoPageTable<F>>, Error> + '_

Create a new IoPageTable as a device resource.

pub unsafe fn new_raw( dev: &Device<Bound>, config: Config, ) -> Result<IoPageTable<F>>

Create a new IoPageTable.

Safety

If successful, then the returned IoPageTable must be dropped before the device is unbound.

pub fn raw_ops(&self) -> *mut io_pgtable_ops

Obtain a raw pointer to the underlying struct io_pgtable_ops.

pub fn raw_pgtable(&self) -> *mut io_pgtable

Obtain a raw pointer to the underlying struct io_pgtable.

pub fn raw_cfg(&self) -> *mut io_pgtable_cfg

Obtain a raw pointer to the underlying struct io_pgtable_cfg.

pub unsafe fn map_pages( &self, iova: usize, paddr: PhysAddr, pgsize: usize, pgcount: usize, prot: u32, flags: Flags, ) -> (usize, Result)

Map a physically contiguous range of pages of the same size.

Even if successful, this operation may not map the entire range. In that case, only a prefix of the range is mapped, and the returned integer indicates its length in bytes. In this case, the caller will usually call map_pages again for the remaining range.

The returned Result indicates whether an error was encountered while mapping pages. Note that this may return a non-zero length even if an error was encountered. The caller will usually unmap the relevant pages on error.

The caller must flush the TLB before using the pgtable to access the newly created mapping.

Safety

• No other io-pgtable operation may access the range iova .. iova+pgsize*pgcount while this map_pages operation executes.
• This page table must not contain any mapping that overlaps with the mapping created by this call.
• If this page table is live, then the caller must ensure that it’s okay to access the physical address being mapped for the duration in which it is mapped.

pub unsafe fn unmap_pages( &self, iova: usize, pgsize: usize, pgcount: usize, ) -> usize

Unmap a range of virtually contiguous pages of the same size.

This may not unmap the entire range, and returns the length of the unmapped prefix in bytes.

Safety

• No other io-pgtable operation may access the range iova .. iova+pgsize*pgcount while this unmap_pages operation executes.
• This page table must contain one or more consecutive mappings starting at iova whose total size is pgcount * pgsize.

impl IoPageTable<ARM64LPAES1>

pub unsafe fn ttbr(&self) -> u64

Access the ttbr field of the configuration.

This is the physical address of the page table, which may be passed to the device that needs to use it.

Safety

The caller must ensure that the device stops using the page table before dropping it.

pub fn mair(&self) -> u64

Access the mair field of the configuration.

Trait Implementations

impl<F: IoPageTableFmt> Drop for IoPageTable<F>

fn drop(&mut self)

Executes the destructor for this type.

impl<F: IoPageTableFmt> Send for IoPageTable<F>

impl<F: IoPageTableFmt> Sync for IoPageTable<F>