Struct Args 

pub(crate) struct Args {
    pub(crate) profile: Profile,
    pub(crate) quantum: Option<u64>,
    pub(crate) new_flow_bonus: Option<u64>,
    pub(crate) starvation: Option<u64>,
    pub(crate) verbose: bool,
    pub(crate) interval: u64,
}

🍰 scx_cake: A sched_ext scheduler applying CAKE bufferbloat concepts

This scheduler adapts CAKE’s DRR++ (Deficit Round Robin++) algorithm for CPU scheduling, providing low-latency scheduling for gaming and interactive workloads while maintaining fairness.

PROFILES set all tuning parameters at once. Individual options override profile defaults.

4-TIER SYSTEM (classified by avg_runtime): T0 Critical (<100µs): IRQ, input, audio, network T1 Interact (<2ms): compositor, physics, AI T2 Frame (<8ms): game render, encoding T3 Bulk (≥8ms): compilation, background

EXAMPLES: scx_cake # Run with gaming profile (default) scx_cake -p esports # Ultra-low-latency for competitive play scx_cake –quantum 1500 # Gaming profile with custom quantum scx_cake -v # Run with live TUI stats display

Fields

profile: Profile

Scheduler profile preset.

Profiles configure all tier thresholds, quantum multipliers, and wait budgets. Individual CLI options (–quantum, etc.) override profile values.

ESPORTS: Ultra-low-latency for competitive gaming.

• Quantum: 1000µs, Starvation: 50ms

LEGACY: Optimized for older/lower-power hardware.

• Quantum: 4000µs, Starvation: 200ms

GAMING: Optimized for low-latency gaming and interactive workloads.

• Quantum: 2000µs, Starvation: 100ms

DEFAULT: Balanced profile for general desktop use.

• Currently same as gaming; will diverge in future versions

quantum: Option<u64>

Base scheduling time slice in MICROSECONDS [default: 2000].

How long a task runs before potentially yielding.

Smaller quantum = more responsive but higher overhead. Esports: 1000µs | Gaming: 2000µs | Legacy: 4000µs Recommended range: 1000-8000µs

new_flow_bonus: Option<u64>

Bonus time for newly woken tasks in MICROSECONDS [default: 8000].

Tasks waking from sleep get this extra time added to their deficit, allowing them to run longer on first dispatch. Helps bursty workloads.

Esports: 4000µs | Gaming: 8000µs Recommended range: 4000-16000µs

starvation: Option<u64>

Max run time before forced preemption in MICROSECONDS [default: 100000].

Safety limit: tasks running longer than this are forcibly preempted. Prevents any single task from monopolizing the CPU.

Esports: 50000µs (50ms) | Gaming: 100000µs (100ms) | Legacy: 200000µs (200ms) Recommended range: 50000-200000µs

verbose: bool

Enable live TUI (Terminal User Interface) with real-time statistics.

Shows dispatch counts per tier, tier transitions, wait time stats, and system topology information. Press ‘q’ to exit TUI mode.

interval: u64

Statistics refresh interval in SECONDS (only with –verbose).

How often the TUI updates. Lower values = more responsive but higher overhead. Has no effect without –verbose.

Default: 1 second

Implementations

impl Args

pub(crate) fn effective_values(&self) -> (u64, u64, u64)

Get effective values (profile defaults with CLI overrides applied)

Trait Implementations

impl Args for Args

fn group_id() -> Option<Id>

Report the [ArgGroup::id][crate::ArgGroup::id] for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self via [FromArgMatches::from_arg_matches_mut]

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate self via [FromArgMatches::update_from_arg_matches_mut]

impl CommandFactory for Args

fn command<'b>() -> Command

Build a [Command] that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a [Command] that can update self.

impl Debug for Args

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

Formats the value using the given formatter.

impl FromArgMatches for Args

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for Args

fn parse() -> Self

Parse from std::env::args_os(), [exit][Error::exit] on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, [exit][Error::exit] on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, [exit][Error::exit] on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.