Struct RequestBuffers

pub struct RequestBuffers<'a> { /* private fields */ }

An accessor for the memory associated with an IO request.

Implementations

impl<'a> RequestBuffers<'a>

pub fn new( guest_memory: &'a GuestMemory, range: PagedRange<'a>, is_write: bool, ) -> Self

Creates a new request buffer from the given memory ranges.

pub fn is_empty(&self) -> bool

Returns true if the buffer is empty.

pub fn len(&self) -> usize

Return the total length of the buffers in bytes.

pub fn guest_memory(&self) -> &GuestMemory

Returns the guest memory accessor.

pub fn range(&self) -> PagedRange<'_>

Return the internal paged range.

pub fn is_aligned(&self, alignment: usize) -> bool

Returns whether the buffers are all aligned to at least alignment bytes.

alignment must be a power of two.

pub fn writer(&self) -> impl MemoryWrite + '_

Gets a memory writer for the buffers.

Returns an empty writer if the buffers are only available for read access.

pub fn reader(&self) -> impl MemoryRead + '_

Gets a memory reader for the buffers.

pub fn lock(&self, for_write: bool) -> Result<LockedIoBuffers, AccessError>

Locks the guest memory ranges described by this buffer and returns an object containing IoBuffers, suitable for executing asynchronous I/O operations.

pub fn subrange(&self, offset: usize, len: usize) -> Self

Returns a subrange of this set of buffers.

Panics if offset + len > self.len().

Trait Implementations

impl<'a> Clone for RequestBuffers<'a>

fn clone(&self) -> RequestBuffers<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for RequestBuffers<'a>

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

Formats the value using the given formatter.