Struct UserSlice 

pub struct UserSlice {
    address: u64,
    length: u64,
}

Data structure to store fat pointers provided by userspace

Fields

address: u64

length: u64

Implementations

impl UserSlice

pub fn new(address: u64, length: u64) -> Result<Self, SyscallError>

Create a new UserSlice from the given params

The returned Ok(Self) is guaranteed to be fully below USER_MAX

Errors

Returns SyscallError::BadAddress if the given memory region isn’t fully below USER_MAX or if it overflows

pub fn len(&self) -> u64

Getter for self.length

pub fn is_empty(&self) -> bool

Check whether the given self is empty (zero-length)

pub fn copy_to_slice(&self, slice: &mut [u8])

Copies the userspace data into the given slice

Panics

• slice is not exactly as large as this UserSlice (only with the debug-checks feature)
• any of the cases listed on Self::partial_copy_to_slice

pub fn partial_copy_to_slice(&self, slice: &mut [u8], offset: u64, length: u64)

Copies a part of the given userspace data into the given slice

Panics

• offset + length overflows
• the requested range reaches past the end of this UserSlice
• slice is smaller than length

All of these indicate a kernel-side bug, never bad userspace input

fn incorrect_size_panic(&self, dst_len: usize, src_len: u64) -> !

Panic Message for when dst_len is not sized like src_len (they are not equal)

Trait Implementations

impl Clone for UserSlice

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for UserSlice

impl Debug for UserSlice

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

Formats the value using the given formatter.