Struct Options 

pub struct Options { /* private fields */ }

Bounds both in-flight SQEs and the reusable owned scratch arena. No SQPOLL thread is started. A large operation is split into bounded contiguous chunks.

Implementations

impl Options

pub fn with_syscall_writes(self, enabled: bool) -> Self

Execute buffered positional writes with ordered syscalls, avoiding worker scheduling and the kernel-facing scratch copy. Disabled by default; reads and fsyncs still use the ring unless separately configured.

pub fn with_cached_reads(self, enabled: bool) -> Self

Require two kernel-page-cache probe hits per cohort of 16 small reads (<=64 KiB) before selecting ordinary positional reads. A miss switches the rest of the call to bounded ring batching. A mixed/evicted cohort may block for at most 14 unprobed reads before checking again. Large reads always use the ring; partial or zero probe replies never imply EOF. Disabled by default; unsupported filesystems retain ordinary ring reads.

pub fn with_queue_depth(self, depth: NonZeroU32) -> Self

Maximum submissions in a wave (1..=4096). Oversized values fail at connection rather than allocating an arbitrarily large kernel ring.

pub fn with_max_batch_bytes(self, bytes: NonZeroUsize) -> Self

Maximum aggregate transfer bytes per wave, also bounding scratch storage, independent of caller-facing read allocation limits. Shared read limits still default to 16 MiB. Defaults to 2 MiB to limit copy working sets while preserving many-file concurrency; tune upward for storage that benefits from larger windows.

Trait Implementations

impl Clone for Options

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Options

impl Debug for Options

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

Formats the value using the given formatter.

impl Default for Options

fn default() -> Self

Returns the “default value” for a type.