Struct UserBuffersInputBuffer 

pub struct UserBuffersInputBuffer<'a, M> { /* private fields */ }

An InputBuffer that read data from user space memory through a TaskMemoryAccessor.

Implementations

impl<'a> UserBuffersInputBuffer<'a, CurrentTask>

pub fn unified_new( task: &'a CurrentTask, buffers: UserBuffers, ) -> Result<Self, Errno>

pub fn unified_new_at( task: &'a CurrentTask, address: UserAddress, length: usize, ) -> Result<Self, Errno>

impl<'a> UserBuffersInputBuffer<'a, Task>

pub fn syscall_new(task: &'a Task, buffers: UserBuffers) -> Result<Self, Errno>

impl<'a> UserBuffersInputBuffer<'a, RemoteMemoryManager>

pub fn remote_new( mm: &'a RemoteMemoryManager, buffers: UserBuffers, ) -> Result<Self, Errno>

Trait Implementations

impl<'a, M: TaskMemoryAccessor> Buffer for UserBuffersInputBuffer<'a, M>

fn segments_count(&self) -> Result<usize, Errno>

Returns the number of segments, if the buffer supports I/O directly to/from individual segments.

fn peek_each_segment( &mut self, callback: &mut PeekBufferSegmentsCallback<'_>, ) -> Result<(), Errno>

Calls the callback with each segment backing this buffer.

fn peek_all_segments_as_iovecs(&mut self) -> Result<IovecsRef<'_, iovec>, Errno>

Returns all the segments backing this Buffer.

impl<'a, M> Debug for UserBuffersInputBuffer<'a, M>

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

Formats the value using the given formatter.

impl<'a, M: TaskMemoryAccessor> InputBuffer for UserBuffersInputBuffer<'a, M>

fn peek(&mut self, uninit_bytes: &mut [MaybeUninit<u8>]) -> Result<usize, Errno>

Peeks the content of this buffer into buffer. If buffer is too small, the read will be partial. If buffer is too large, the remaining bytes will be left untouched.

fn peek_each( &mut self, callback: &mut InputBufferCallback<'_>, ) -> Result<usize, Errno>

Calls callback for each segment to peek data from. callback must returns the number of bytes actually peeked. When it returns less than the size of the output buffer, the read is stopped.

fn drain(&mut self) -> usize

Clear the remaining content in the buffer. Returns the number of bytes swallowed. After this method returns, available() will returns 0. This does not touch the data in the buffer.

fn advance(&mut self, length: usize) -> Result<(), Errno>

Consumes length bytes of data from this buffer.

fn available(&self) -> usize

Returns the number of bytes available to be read from the buffer.

fn bytes_read(&self) -> usize

Returns the number of bytes already read from the buffer.

fn read_each( &mut self, callback: &mut InputBufferCallback<'_>, ) -> Result<usize, Errno>

Calls callback for each segment to read data from. callback must returns the number of bytes actually read. When it returns less than the size of the output buffer, the read is stopped.

fn read_all(&mut self) -> Result<Vec<u8>, Errno>

Read all the remaining content in this buffer and returns it as a Vec.

fn peek_all(&mut self) -> Result<Vec<u8>, Errno>

Peek all the remaining content in this buffer and returns it as a Vec.

fn read(&mut self, buffer: &mut [MaybeUninit<u8>]) -> Result<usize, Errno>

Write the content of this buffer into buffer. If buffer is too small, the read will be partial. If buffer is too large, the remaining bytes will be left untouched.

fn read_exact(&mut self, buffer: &mut [MaybeUninit<u8>]) -> Result<usize, Errno>

Read the exact number of bytes required to fill buf.