Struct IoUringConfig 

pub struct IoUringConfig {
    pub ring_entries: u32,
    pub mode: RingMode,
    pub sqpoll_idle_ms: u32,
    pub sqpoll_cpu: Option<u32>,
    pub buffer_size: usize,
    pub buffer_count: usize,
    pub coop_taskrun: bool,
    pub single_issuer: bool,
    pub direct_table: bool,
    pub direct_table_size: u32,
}

Configuration for io_uring operations.

Fields

ring_entries: u32

Number of submission queue entries (power of 2, typically 256-4096).

mode: RingMode

Ring operation mode.

sqpoll_idle_ms: u32

SQPOLL idle timeout in milliseconds before kernel thread sleeps. Only used when mode uses SQPOLL.

sqpoll_cpu: Option<u32>

CPU to pin the SQPOLL kernel thread to (usually same NUMA node as core). Only used when mode uses SQPOLL.

buffer_size: usize

Size of each registered buffer in bytes (typically 64KB).

buffer_count: usize

Number of buffers in the registered pool.

coop_taskrun: bool

Enable cooperative task running to reduce kernel-userspace transitions.

single_issuer: bool

Optimize for single-threaded submission (thread-per-core model).

direct_table: bool

Enable direct file descriptor table for faster operations.

direct_table_size: u32

Number of direct file descriptor slots.

Implementations

impl IoUringConfig

pub fn builder() -> IoUringConfigBuilder

Create a new builder for IoUringConfig.

pub fn auto() -> Self

Create configuration with automatic detection.

Detects system capabilities and generates an optimal configuration:

• Enables SQPOLL mode on Linux 5.11+ with the io-uring feature
• Enables IOPOLL mode on Linux 5.19+ with NVMe storage
• Uses optimal buffer sizes based on available memory

Example

use laminar_core::io_uring::IoUringConfig;

let config = IoUringConfig::auto();
println!("SQPOLL: {}", config.mode.uses_sqpoll());

pub const fn total_buffer_size(&self) -> usize

Total buffer pool size in bytes.

pub fn validate(&self) -> Result<(), IoUringError>

Validate the configuration.

Errors

Returns an error if the configuration is invalid.

Trait Implementations

impl Clone for IoUringConfig

fn clone(&self) -> IoUringConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IoUringConfig

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

Formats the value using the given formatter.

impl Default for IoUringConfig

fn default() -> Self

Returns the “default value” for a type.