Struct AioContext

pub struct AioContext { /* private fields */ }

AioContext provides a submission queue for asycnronous I/O operations to block devices within the Linux kernel.

Implementations

impl AioContext

pub fn new<E>(executor: &E, nr: usize) -> Result<AioContext, Error>

where E: Executor<Execute<AioPollFuture>>,

Create a new AioContext that is driven by the provided event loop.

Params

• executor: The executor used to spawn the background polling task
• nr: Number of submission slots for IO requests

pub fn read<ReadWriteHandle>( &self, fd: RawFd, offset: u64, buffer_obj: ReadWriteHandle, ) -> AioReadResultFuture<ReadWriteHandle>

where ReadWriteHandle: AsMut<[u8]>,

Initiate an asynchronous read operation on the given file descriptor for reading data from the provided absolute file offset into the buffer. The buffer also determines the number of bytes to be read, which should be a multiple of the underlying device block size.

Params:

• fd: The file descriptor of the file from which to read
• offset: The file offset where we want to read from
• buffer: A buffer to receive the read results

pub fn write<ReadOnlyHandle>( &self, fd: RawFd, offset: u64, buffer: ReadOnlyHandle, ) -> AioWriteResultFuture<ReadOnlyHandle>

where ReadOnlyHandle: AsRef<[u8]>,

Initiate an asynchronous write operation on the given file descriptor for writing data to the provided absolute file offset from the buffer. The buffer also determines the number of bytes to be written, which should be a multiple of the underlying device block size.

Params:

• fd: The file descriptor of the file to which to write
• offset: The file offset where we want to write to
• buffer: A buffer holding the data to be written

pub fn write_sync<ReadOnlyHandle>( &self, fd: RawFd, offset: u64, buffer_obj: ReadOnlyHandle, sync_level: SyncLevel, ) -> AioWriteResultFuture<ReadOnlyHandle>

where ReadOnlyHandle: AsRef<[u8]>,

Initiate an asynchronous write operation on the given file descriptor for writing data to the provided absolute file offset from the buffer. The buffer also determines the number of bytes to be written, which should be a multiple of the underlying device block size.

Params:

• fd: The file descriptor of the file to which to write
• offset: The file offset where we want to write to
• buffer: A buffer holding the data to be written
• sync_level: A synchronization level to apply for this write operation

pub fn sync(&self, fd: RawFd) -> AioSyncResultFuture

Initiate an asynchronous sync operation on the given file descriptor.

Caveat: While this operation is defined in the ABI, this command is known to fail with an invalid argument error (EINVAL) in many, if not all, cases. You are kind of on your own.

Params:

• fd: The file descriptor of the file to which to write

pub fn data_sync(&self, fd: RawFd) -> AioSyncResultFuture

Initiate an asynchronous data sync operation on the given file descriptor.

Caveat: While this operation is defined in the ABI, this command is known to fail with an invalid argument error (EINVAL) in many, if not all, cases. You are kind of on your own.

Params:

• fd: The file descriptor of the file to which to write

Trait Implementations

impl Clone for AioContext

fn clone(&self) -> AioContext

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AioContext

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

Formats the value using the given formatter.