Enum WorkTypeValidationError 

pub enum WorkTypeValidationError {
    ZeroBurstDuration {
        group_idx: usize,
    },
    ZeroSleepDuration {
        group_idx: usize,
    },
    ZeroTimerInterval {
        group_idx: usize,
    },
    NetTrafficFrameBytes {
        frame_bytes: u16,
        group_idx: usize,
    },
    IrqWakeFrameBytes {
        frame_bytes: u16,
        group_idx: usize,
    },
    InsufficientWakeChainDepth {
        depth: usize,
        group_idx: usize,
    },
    NonDivisibleWorkerCount {
        name: String,
        group_idx: usize,
        group_size: usize,
        num_workers: usize,
    },
    ZeroIpcVarianceParam {
        field: &'static str,
        group_idx: usize,
    },
}

Spawn-time validation failures for WorkType preconditions.

Returned (boxed inside anyhow::Error) by WorkloadHandle::spawn when a per-group WorkSpec violates a runtime invariant the variant doc declares as a precondition. Tests that need to assert on a specific variant downcast via err.downcast_ref::<WorkTypeValidationError>(); the Display impl carries the same human-readable text the previous anyhow::bail! strings did so call sites that match on the rendered message keep working.

Each variant carries group_idx, a unified group index where 0 is the primary group and the i-th WorkloadConfig::composed entry is group_idx == i + 1, so multi-group scenarios can locate the offending entry without re-parsing the message string. Variants with multiple constraint inputs (depth, divisor, observed count) expose those values as named fields to the same end.

Variants

ZeroBurstDuration

WorkType::IdleChurn with burst_duration == Duration::ZERO. Collapses the per-iteration loop to pure nanosleep so the worker accrues no runtime — useless as a scheduler test. See the variant doc’s “Spawn-time validation” section for the full rationale.

Fields

group_idx: usize

Unified group index of the offending group: 0 for the primary group, i + 1 for WorkloadConfig::composed[i].

ZeroSleepDuration

WorkType::IdleChurn with sleep_duration == Duration::ZERO. Collapses the per-iteration loop to a CPU-bound burst with no idle path; the kernel’s nanosleep(0) is yield-like rather than idle-like. The diagnostic steers the caller to WorkType::SpinWait (pure CPU spin) or WorkType::YieldHeavy (the closer overlap).

Fields

group_idx: usize

Unified group index of the offending group: 0 for the primary group, i + 1 for WorkloadConfig::composed[i].

ZeroTimerInterval

WorkType::TimerLatency with interval_us == 0. A zero interval never advances the absolute deadline, collapsing the cyclictest loop to a tight busy-spin rather than a timer-latency probe.

Fields

group_idx: usize

Unified group index of the offending group: 0 for the primary group, i + 1 for WorkloadConfig::composed[i].

NetTrafficFrameBytes

WorkType::NetTraffic with frame_bytes outside [60, 1514]. Below 60 (ETH_ZLEN) there is no room for the L2 header the loopback echoes; above 1514 (standard MTU + header) the frame exceeds the virtio-net MTU.

Fields

frame_bytes: u16

The offending frame_bytes value the caller supplied.

group_idx: usize

Unified group index of the offending group: 0 for the primary group, i + 1 for WorkloadConfig::composed[i].

IrqWakeFrameBytes

WorkType::IrqWake with frame_bytes outside [60, 1514] — same bound and reasoning as Self::NetTrafficFrameBytes (the IrqWake sender reuses the NetTraffic frame builder).

Fields

frame_bytes: u16

The offending frame_bytes value the caller supplied.

group_idx: usize

Unified group index of the offending group: 0 for the primary group, i + 1 for WorkloadConfig::composed[i].

InsufficientWakeChainDepth

WorkType::WakeChain with depth < 2. A 1-stage chain has no successor to wake, and the post-fork close-other-fds block would close the worker’s own write end (deadlock).

Fields

depth: usize

The offending depth value the caller supplied.

group_idx: usize

Unified group index of the offending group: 0 for the primary group, i + 1 for WorkloadConfig::composed[i].

NonDivisibleWorkerCount

num_workers is not a positive multiple of the variant’s worker_group_size. Affects every grouped variant (paired, fan-out, herd, contention, chain). The diagnostic names the variant via WorkType::name.

Fields

name: String

PascalCase variant name from WorkType::name.

group_idx: usize

Unified group index of the offending group: 0 for the primary group, i + 1 for WorkloadConfig::composed[i].

group_size: usize

Required group size (the variant’s worker_group_size).

num_workers: usize

The num_workers count the caller supplied.

ZeroIpcVarianceParam

WorkType::IpcVariance with one of hot_iters, cold_iters, or period_iters equal to 0. A zero in any of the three collapses the alternation: zero hot_iters produces a pure cold-phase memory loop, zero cold_iters produces a pure ALU loop (use WorkType::AluHot directly for that), and zero period_iters produces a worker that never advances past the first stop check. Each rejection names the offending field so the caller knows which to fix.

Fields

field: &'static str

Static name of the offending field — "hot_iters", "cold_iters", or "period_iters".

group_idx: usize

Unified group index of the offending group: 0 for the primary group, i + 1 for WorkloadConfig::composed[i].

Trait Implementations

impl Clone for WorkTypeValidationError

fn clone(&self) -> WorkTypeValidationError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkTypeValidationError

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

Formats the value using the given formatter.

impl Display for WorkTypeValidationError

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

Formats the value using the given formatter.

impl Error for WorkTypeValidationError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl Hash for WorkTypeValidationError

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for WorkTypeValidationError

fn eq(&self, other: &WorkTypeValidationError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for WorkTypeValidationError

impl StructuralPartialEq for WorkTypeValidationError