Struct Config 

#[non_exhaustive]
pub struct Config {
    pub gro: bool,
    pub gso: bool,
    pub multishot: bool,
    pub rx_buffers_max: u16,
    pub rx_buffer_len: usize,
    pub tx_buffers_max: u16,
    pub tx_buffer_len: usize,
}

How a socket uses the ring. The defaults are the production path; the toggles exist so the benchmarks can ablate one mechanism at a time.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

gro: bool

Coalesce received datagrams with UDP_GRO.

gso: bool

Send with a UDP_SEGMENT control message instead of one sendmsg per datagram.

multishot: bool

Receive through one persistent multishot recvmsg and the provided buffer ring, instead of re-armed oneshot receives.

rx_buffers_max: u16

Receive pool ceiling: at most this many buffers, and at most 32768.

Each receive completion consumes one buffer whatever its size, so the pool is a queue depth in packets rather than in bytes: GRO coalescing collapses as connections multiply, and the depth a socket needs follows that, not its bitrate. Buffers are allocated on demand, so this bounds the memory rather than reserving it.

rx_buffer_len: usize

Receive pool: bytes per buffer. Must hold one worst-case receive.

tx_buffers_max: u16

Send pool ceiling: at most this many buffers, allocated on demand.

One buffer stages one GSO train, so the pool is the socket’s in-flight send concurrency. Set it to 1 to serialize sends.

tx_buffer_len: usize

Send pool: bytes per buffer, the ceiling for one GSO train.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.