Struct kernel::AppSlice

pub struct AppSlice<L, T> { /* fields omitted */ }

Buffer of memory shared from an app to the kernel.

This is the type created after an app calls the allow syscall.

Implementations

impl<L, T> AppSlice<L, T>

pub unsafe fn new_external(
    ptr: NonNull<T>,
    len: usize,
    appid: AppId,
    _capability: &dyn ExternalProcessCapability
) -> AppSlice<L, T>

Safety: Trusts that ptr + len is a buffer in the memory region owned by appid and that no other references to that memory range exist.

This constructor is public but protected with a capability to enable external implementations of ProcessType to create AppSlices.

pub fn len(&self) -> usize

Number of bytes in the AppSlice.

If the app died, has restarted, or its AppId identifier changed for any other reason, return an accessible length of zero, consistent with the AsRef and AsMut implementations.

pub fn ptr(&self) -> *const T

Get the raw pointer to the buffer. This will be a pointer inside of the app's memory region.

pub fn iter(&self) -> Iter<'_, T>

Returns an iterator over the slice

See std::slice::iter().

Internally this uses AsRef, hence when the app dies, restarts or the AppId changes for any other reason, the iterator will be of zero length.

pub fn iter_mut(&mut self) -> IterMut<'_, T>

Returns an iterator that allows modifying each value

See std::slice::iter_mut().

Internally this uses AsMut, hence when the app dies, restarts or the AppId changes for any other reason, the iterator will be of zero length.

pub fn chunks(&self, size: usize) -> Chunks<'_, T>

Iterate over chunk_size elements at a time, starting at the beginning of the AppSlice.

See std::slice::chunks().

Internally this uses AsRef, hence when the app dies, restarts or the AppId changes for any other reason, a Chunks iterator of zero length will be returned.

pub fn chunks_mut(&mut self, size: usize) -> ChunksMut<'_, T>

Mutably iterate over chunk_size elements at a time, starting at the beginning of the AppSlice.

See std::slice::chunks_mut().

Internally this uses AsMut, hence when the app dies, restarts or the AppId changes for any other reason, a ChunksMut iterator of zero length will be returned.

Panics

Panics if chunk_size is 0.

Trait Implementations

impl<L, T> AsMut<[T]> for AppSlice<L, T>

pub fn as_mut(&mut self) -> &mut [T]

Get a mutable slice reference over the userspace buffer

This first checks whether the app died, restarted, or its AppId identifier changed for any other reason. In this case, a slice of length zero is returned.

impl<L, T> AsRef<[T]> for AppSlice<L, T>

pub fn as_ref(&self) -> &[T]

Get a slice reference over the userspace buffer

This first checks whether the app died, restarted, or its AppId identifier changed for any other reason. In this case, a slice of length zero is returned.