Struct CustomGrant

pub struct CustomGrant<T> { /* private fields */ }

Grant which was allocated from the kernel-owned grant region in a specific process’s memory, separately from a normal Grant.

A CustomGrant allows a capsule to allocate additional memory on behalf of a process.

Implementations

impl<T> CustomGrant<T>

pub fn processid(&self) -> ProcessId

Helper function to get the ProcessId from the custom grant.

pub fn enter<F, R>(&self, fun: F) -> Result<R, Error>

where F: FnOnce(GrantData<'_, T>) -> R,

Gives access to inner data within the given closure.

If the process has since been restarted or crashed, or the memory is otherwise no longer present, then this function will not call the given closure, and will instead directly return Err(Error::NoSuchApp).

Because this function requires &mut self, it should be impossible to access the inner data of a given CustomGrant reentrantly. Thus the reentrance detection we use for non-custom grants is not needed here.