Trait WriteVolatile

pub trait WriteVolatile {
    // Required method
    fn write_volatile<B: BitmapSlice>(
        &mut self,
        buf: &VolatileSlice<'_, B>,
    ) -> Result<usize, VolatileMemoryError>;

    // Provided method
    fn write_all_volatile<B: BitmapSlice>(
        &mut self,
        buf: &VolatileSlice<'_, B>,
    ) -> Result<(), VolatileMemoryError> { ... }
}

A version of the standard library’s Write trait that operates on volatile memory instead of slices.

This trait is needed as rust slices (&[u8] and &mut [u8]) cannot be used when operating on guest memory 1.

Required Methods

fn write_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<usize, VolatileMemoryError>

Tries to write some bytes from the given VolatileSlice buffer, returning how many bytes were written.

The behavior of implementations should be identical to Write::write

Provided Methods

fn write_all_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<(), VolatileMemoryError>

Tries write the entire content of the given VolatileSlice buffer to self returning an error if not all bytes could be written.

The default implementation is identical to that of Write::write_all

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl WriteVolatile for &mut [u8]

fn write_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<usize, VolatileMemoryError>

fn write_all_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<(), VolatileMemoryError>

impl WriteVolatile for Vec<u8>

fn write_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<usize, VolatileMemoryError>

impl WriteVolatile for File

fn write_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<usize, VolatileMemoryError>

impl WriteVolatile for Cursor<&mut [u8]>

fn write_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<usize, VolatileMemoryError>

impl WriteVolatile for Stdout

fn write_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<usize, VolatileMemoryError>

impl WriteVolatile for TcpStream

fn write_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<usize, VolatileMemoryError>

impl WriteVolatile for BorrowedFd<'_>

fn write_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<usize, VolatileMemoryError>

impl WriteVolatile for OwnedFd

fn write_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<usize, VolatileMemoryError>

impl WriteVolatile for UnixStream

fn write_volatile<B: BitmapSlice>( &mut self, buf: &VolatileSlice<'_, B>, ) -> Result<usize, VolatileMemoryError>

Implementors