KTSTR_STALL_POLL_MS_ENV

Constant KTSTR_STALL_POLL_MS_ENV 

Source
pub const KTSTR_STALL_POLL_MS_ENV: &str = "KTSTR_STALL_POLL_MS";
Expand description

Name of the environment variable that overrides the poll cadence (in milliseconds) of the host-mode stall monitor in crate::scenario::host_stall.

The monitor runs in a background thread and samples /proc/<pid>/sched every N ms for every worker pid the scenario spawned; W consecutive samples with Δnr_switches == 0 AND Δsum_exec_runtime == 0 flip the stall predicate. Default cadence is 500 ms × W=4 = 2 s detection latency.

§Empty = unset (also: 0 / unparseable)

Empty / unset / 0 / unparseable falls back to the default (crate::scenario::host_stall::DEFAULT_POLL_INTERVAL_MS). Mirrors the empty-as-unset contract documented on the sibling KTSTR_*_ENV constants so a shell KTSTR_STALL_POLL_MS= quirk silently degrades to default behavior rather than poisoning the poller with a zero interval (which would either busy-loop or be no-op-rejected).

Read once at crate::scenario::host_stall::spawn_monitor when the scenario engine spawns the monitor; mid-scenario env mutations are NOT observed by the running thread.

Single source of truth so the name is not spelled by hand at each reader. Mirrors the sibling KTSTR_HOST_CGROUP_PARENT_ENV constant-defined naming convention; a single grep across KTSTR_*_ENV consts gives the operator the complete env-var inventory.