Struct WorkloadShape 

pub struct WorkloadShape {
    pub n_thieves: usize,
    pub batch_size: Option<usize>,
    pub wait_idle: bool,
}

Caller-supplied workload shape feeding the routing decision.

Fields

n_thieves: usize

Number of consumer threads / processes that will drain the deque concurrently. >= 2 is the multi-thief regime where URD’s per-mailbox layout amortizes against the shared-head CAS contention Chase-Lev / KHPD / LOH all pay.

batch_size: Option<usize>

Some(K) when the producer hands the dispatcher a batch of K items per call; None when the producer dispatches one item at a time (request-reply / latency-bound).

wait_idle: bool

true when the consumer should halt the logical CPU between batches (WAITPKG on capable silicon; PAUSE-spin elsewhere). Setting this routes to URD even at n_thieves == 1.

Implementations

impl WorkloadShape

pub const fn required_signature(&self) -> AxisMask

The direction signature this workload requires from its transport: which K-axes the variant must engage to handle this shape.

Per-item dispatch (no batch) requires nothing beyond the empty signature (Chase-Lev’s signature is a superset of any empty requirement). Batched dispatch requires K_inner + K_outer engaged (per-slot packing AND per-batch counter amortization). Multi-thief or wait-idle requires K_consumer + K_radius engaged (per-thief mailboxes and CPUID-dispatched publish mechanism).

pub fn request_reply() -> Self

Request-reply: per-item dispatch, single thief, no idle wait.

pub fn producer_fast(k: usize) -> Self

Producer-fast batch of k items, single thief.

pub fn fan_out(n_thieves: usize, k: usize) -> Self

Fan-out: producer batches across multiple thieves. n_thieves

= 2 + batch_size set routes to URD.

Trait Implementations

impl Clone for WorkloadShape

fn clone(&self) -> WorkloadShape

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for WorkloadShape

impl Debug for WorkloadShape

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

Formats the value using the given formatter.