Struct PollSource

pub struct PollSource<F> {
    registered_source: RegisteredSource<F>,
}

Async wrapper for an IO source that uses the FD executor to drive async operations.

Fields

registered_source: RegisteredSource<F>

Implementations

impl<F: AsRawDescriptor> PollSource<F>

pub fn new(f: F, ex: &Arc<RawExecutor<EpollReactor>>) -> Result<Self>

Create a new PollSource from the given IO source.

impl<F: AsRawDescriptor> PollSource<F>

pub async fn read_to_vec( &self, file_offset: Option<u64>, vec: Vec<u8>, ) -> AsyncResult<(usize, Vec<u8>)>

Reads from the iosource at file_offset and fill the given vec.

pub async fn read_to_mem( &self, file_offset: Option<u64>, mem: Arc<dyn BackingMemory + Send + Sync>, mem_offsets: impl IntoIterator<Item = MemRegion>, ) -> AsyncResult<usize>

Reads to the given mem at the given offsets from the file starting at file_offset.

pub async fn wait_readable(&self) -> AsyncResult<()>

Wait for the FD of self to be readable.

pub async fn write_from_vec( &self, file_offset: Option<u64>, vec: Vec<u8>, ) -> AsyncResult<(usize, Vec<u8>)>

Writes from the given vec to the file starting at file_offset.

pub async fn write_from_mem( &self, file_offset: Option<u64>, mem: Arc<dyn BackingMemory + Send + Sync>, mem_offsets: impl IntoIterator<Item = MemRegion>, ) -> AsyncResult<usize>

Writes from the given mem from the given offsets to the file starting at file_offset.

pub async fn fsync(&self) -> AsyncResult<()>

Safety

Sync all completed write operations to the backing storage.

pub async fn punch_hole(&self, file_offset: u64, len: u64) -> AsyncResult<()>

punch_hole

pub async fn write_zeroes_at( &self, file_offset: u64, len: u64, ) -> AsyncResult<()>

write_zeroes_at

pub async fn fdatasync(&self) -> AsyncResult<()>

Sync all data of completed write operations to the backing storage, avoiding updating extra metadata.

pub fn into_source(self) -> F

Yields the underlying IO source.

pub fn as_source_mut(&mut self) -> &mut F

Provides a mutable ref to the underlying IO source.

pub fn as_source(&self) -> &F

Provides a ref to the underlying IO source.