Struct PMPUserMPU

pub struct PMPUserMPU<const MAX_REGIONS: usize, P: TORUserPMP<MAX_REGIONS> + 'static> {
    pub pmp: P,
    /* private fields */
}

Adapter from a generic PMP implementation exposing TOR-type regions to the Tock mpu::MPU trait. See TORUserPMP.

Fields

pmp: P

Underlying hardware PMP implementation, exposing a number (up to P::MAX_REGIONS) of memory protection regions with a 4-byte enforcement granularity.

Implementations

impl<const MAX_REGIONS: usize, P: TORUserPMP<MAX_REGIONS> + 'static> PMPUserMPU<MAX_REGIONS, P>

pub fn new(pmp: P) -> Self

Trait Implementations

impl<const MAX_REGIONS: usize, P: TORUserPMP<MAX_REGIONS> + 'static> MPU for PMPUserMPU<MAX_REGIONS, P>

type MpuConfig = PMPUserMPUConfig<MAX_REGIONS>

MPU-specific state that defines a particular configuration for the MPU. That is, this should contain all of the required state such that the implementation can be passed an object of this type and it should be able to correctly and entirely configure the MPU.

fn enable_app_mpu(&self)

Enables the MPU for userspace apps.

fn disable_app_mpu(&self)

Disables the MPU for userspace apps.

fn number_total_regions(&self) -> usize

Returns the maximum number of regions supported by the MPU.

fn new_config(&self) -> Option<Self::MpuConfig>

Creates a new empty MPU configuration.

fn reset_config(&self, config: &mut Self::MpuConfig)

Resets an MPU configuration.

fn allocate_region( &self, unallocated_memory_start: *const u8, unallocated_memory_size: usize, min_region_size: usize, permissions: Permissions, config: &mut Self::MpuConfig, ) -> Option<Region>

Allocates a new MPU region.

fn remove_memory_region( &self, region: Region, config: &mut Self::MpuConfig, ) -> Result<(), ()>

Removes an MPU region within app-owned memory.

fn allocate_app_memory_region( &self, unallocated_memory_start: *const u8, unallocated_memory_size: usize, min_memory_size: usize, initial_app_memory_size: usize, initial_kernel_memory_size: usize, permissions: Permissions, config: &mut Self::MpuConfig, ) -> Option<(*const u8, usize)>

Chooses the location for a process’s memory, and allocates an MPU region covering the app-owned part.

fn update_app_memory_region( &self, app_memory_break: *const u8, kernel_memory_break: *const u8, permissions: Permissions, config: &mut Self::MpuConfig, ) -> Result<(), ()>

Updates the MPU region for app-owned memory.

fn configure_mpu(&self, config: &Self::MpuConfig)

Configures the MPU with the provided region configuration.