Struct Physical

pub struct Physical<P> { /* private fields */ }

Physical slice wrapper with type annotation.

This struct wraps slices in RISC-V physical memory by low and high part of the physical base address as well as its length. It is usually used by SBI extensions as parameter types to pass base address and length parameters on physical memory other than a virtual one.

Generic parameter P represents a hint of how this physical slice would be used. For example, Physical<&[u8]> represents an immutable reference to physical byte slice, while Physical<&mut [u8]> represents a mutable one.

An SBI implementation should load or store memory using both phys_addr_lo and phys_addr_hi combined as base address. A supervisor program (kernels etc.) should provide continuous physical memory, wrapping its reference using this structure before passing into SBI runtime.

Implementations

impl<P> Physical<P>

pub const fn new( num_bytes: usize, phys_addr_lo: usize, phys_addr_hi: usize, ) -> Self

Create a physical memory slice by length and physical address.

pub const fn num_bytes(&self) -> usize

Returns length of the physical memory slice.

pub const fn phys_addr_lo(&self) -> usize

Returns low-part base address of physical memory slice.

pub const fn phys_addr_hi(&self) -> usize

Returns high-part base address of physical memory slice.

Trait Implementations

impl<P: Clone> Clone for Physical<P>

fn clone(&self) -> Physical<P>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<P: Copy> Copy for Physical<P>