Struct Config 

pub struct Config {

    pub q1_slice_ns: u64,
    pub q2_slice_ns: u64,
    pub q3_slice_ns: u64,
    pub budget_max_ns: u64,
    pub alpha: u64,
    pub t_l_ns: u64,
    pub t_h_ns: u64,
    pub ema_half_life_ns: u64,
    pub aging_period_ns: u64,
    pub short_sleep_ns: u64,
    pub short_sleep_rate_limit_ns: u64,
    pub hysteresis_sleep_ns: u64,
    pub long_sleep_ns: u64,
    pub sameq_preempt_min_run_ns: u64,
    pub preempt_slice_ns: u64,
    pub q1_quota: u32,
    pub q2_quota: u32,
    pub dispatch_max_batch: u32,
    pub rtdl_drain_interval_ns: u64,
    pub tree_t_int_ns: u64,
    pub tree_t_bound_ns: u64,
    pub adapt_enabled: bool,
}

Validated scheduling constants.

Every field maps to a const volatile rodata global in src/bpf/main.bpf.c; field names match the BPF globals 1:1 so Config::apply() is a mechanical write-through.

Fields

q1_slice_ns: u64

Q1 request size (interactive), nsecs.

q2_slice_ns: u64

Q2 request size (default), nsecs.

q3_slice_ns: u64

Q3 request size (batch), nsecs.

budget_max_ns: u64

EMA gauge ceiling, nsecs.

alpha: u64

EMA climb aggressiveness (fixed).

t_l_ns: u64

Interactive threshold T_L, nsecs.

t_h_ns: u64

CPU-bound threshold T_H, nsecs.

ema_half_life_ns: u64

EMA decay half-life, nsecs.

aging_period_ns: u64

Global aging period, nsecs.

short_sleep_ns: u64

Short-sleep boost window, nsecs.

short_sleep_rate_limit_ns: u64

Per-task short-sleep boost rate limit, nsecs.

hysteresis_sleep_ns: u64

Sleep counted as “short” for the wake_cnt hysteresis, nsecs.

long_sleep_ns: u64

Sleep beyond which the gauge collapses, nsecs.

sameq_preempt_min_run_ns: u64

Minimum residency before a same-queue wakeup may preempt, nsecs. Zero, the default, makes the interactive rule unconditional.

preempt_slice_ns: u64

Slice cap for a preempting wakeup, nsecs.

q1_quota: u32

Q1 dispatch quota per dispatch() call.

q2_quota: u32

Q2 dispatch quota per dispatch() call.

dispatch_max_batch: u32

Dispatch-loop bound.

rtdl_drain_interval_ns: u64

Drain interval of the realtime-takeover evacuation, nsecs.

tree_t_int_ns: u64

Tree Q1/Q2 band edge, the base of the effective value, nsecs.

tree_t_bound_ns: u64

Tree Q2/Q3 band edge, the base of the effective value, nsecs.

adapt_enabled: bool

Master gate of the threshold adaptation (false = fixed thresholds).

Implementations

impl Config

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

Validate the configuration against the invariants the BPF side relies on (src/bpf/intf.h).

An invalid configuration is a programming error, not a runtime condition: the production path validates Config::default() before any value is written into rodata, and the unit tests drive the same contract through ConfigBuilder::build().

pub fn apply(&self, skel: &mut OpenBpfSkel<'_>) -> Result<()>

Write the validated constants into the BPF object’s rodata section.

Must be called on the opened, not-yet-loaded skeleton, before scx_ops_load!(). The rodata section becomes read-only after load.

pub fn describe(&self) -> String

One-line summary of the applied constants for the startup log.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

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

Compile-time defaults from src/bpf/intf.h.

impl Eq for Config

impl PartialEq for Config

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Config