Struct wasmtime_runtime::mpk::ProtectionKey

pub struct ProtectionKey { /* private fields */ }

An MPK protection key.

The expected usage is:

• receive system-allocated keys from keys
• mark some regions of memory as accessible with ProtectionKey::protect
• allow or disallow access to the memory regions using a ProtectionMask; any accesses to unmarked pages result in a fault
• drop the key

Implementations

impl ProtectionKey

pub fn protect(&self, region: &mut [u8]) -> Result<()>

Mark a page as protected by this ProtectionKey.

This “colors” the pages of region via a kernel pkey_mprotect call to only allow reads and writes when this ProtectionKey is activated (see allow).

Errors

This will fail if the region is not page aligned or for some unknown kernel reason.

pub fn as_stripe(&self) -> usize

Convert the ProtectionKey to its 0-based index; this is useful for determining which allocation “stripe” a key belongs to.

This function assumes that the kernel has allocated key 0 for itself.

Trait Implementations

impl Clone for ProtectionKey

fn clone(&self) -> ProtectionKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ProtectionKey

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

Formats the value using the given formatter.

impl Copy for ProtectionKey