Struct Ring 

pub struct Ring { /* private fields */ }

An I/O ring that manages asynchronous read and write operations. Provides facilities for both single and batch I/O operations with configurable parameters.

Implementations

impl Ring

pub fn create(config: &RingConfig, mount_point: &Path) -> Result<Self>

Creates a new I/O ring with the specified configuration and mount point.

Arguments

• config - Ring configuration parameters
• mount_point - Mount point path for the filesystem

Returns

• Result<Self> - A new Ring instance or an error

pub fn read(&mut self, file: &File, offset: u64, length: usize) -> Result<&[u8]>

Performs a single read operation.

Arguments

• file - The file to read from
• offset - Starting position for the read
• length - Number of bytes to read

Returns

• Result<&[u8]> - The read data as a byte slice or an error

pub fn batch_read( &mut self, jobs: &[impl ReadJob], ) -> Result<Vec<ReadResult<'_>>>

Performs multiple read operations in a batch.

Arguments

• jobs - Slice of read operations to perform

Returns

• Result<Vec<ReadResult<'_>>> - Vector of read results or an error

Errors

• Returns error if number of jobs exceeds ring entries
• Returns error if total read length exceeds buffer size

pub fn write(&mut self, file: &File, buf: &[u8], offset: u64) -> Result<usize>

Performs a single write operation.

Arguments

• file - The file to write to
• buf - Data to write
• offset - Starting position for the write

Returns

• Result<usize> - Number of bytes written or an error

pub fn batch_write(&mut self, jobs: &[impl WriteJob]) -> Result<Vec<i64>>

Performs multiple write operations in a batch.

Arguments

• jobs - Slice of write operations to perform

Returns

• Result<Vec<i64>> - Vector of write results (bytes written) or an error

Errors

• Returns error if number of jobs exceeds ring entries
• Returns error if total write length exceeds buffer size