Struct Opts

pub(crate) struct Opts {

    pub(crate) autopilot: bool,
    pub(crate) autopower: bool,
    pub(crate) performance: bool,
    pub(crate) powersave: bool,
    pub(crate) balanced: bool,
    pub(crate) slice_max_us: u64,
    pub(crate) slice_min_us: u64,
    pub(crate) cpu_pref_order: String,
    pub(crate) no_futex_boost: bool,
    pub(crate) no_core_compaction: bool,
    pub(crate) prefer_smt_core: bool,
    pub(crate) prefer_little_core: bool,
    pub(crate) no_prefer_turbo_core: bool,
    pub(crate) no_freq_scaling: bool,
    pub(crate) stats: Option<f64>,
    pub(crate) monitor: Option<f64>,
    pub(crate) monitor_sched_samples: Option<u64>,
    pub(crate) verbose: u8,
    pub(crate) version: bool,
    pub(crate) help_stats: bool,
}

scx_lavd: Latency-criticality Aware Virtual Deadline (LAVD) scheduler

The rust part is minimal. It processes command line options and logs out scheduling statistics. The BPF part makes all the scheduling decisions. See the more detailed overview of the LAVD design at main.bpf.c.

Fields

autopilot: bool

Automatically decide the scheduler’s power mode based on system load. This is a default mode if you don’t specify the following options:

autopower: bool

Automatically decide the scheduler’s power mode based on the system’s active power profile.

performance: bool

Run in performance mode to get maximum performance.

powersave: bool

Run in powersave mode to minimize power consumption.

balanced: bool

Run in balanced mode aiming for sweetspot between power and performance (default).

slice_max_us: u64

Maximum scheduling slice duration in microseconds.

slice_min_us: u64

Minimum scheduling slice duration in microseconds.

cpu_pref_order: String

List of CPUs in preferred order (e.g., “0-3,7,6,5,4”).

no_futex_boost: bool

Do not boost futex holders.

no_core_compaction: bool

Disable core compaction and schedule tasks across all online CPUs. Core compaction attempts to keep idle CPUs idle in favor of scheduling tasks on CPUs that are already awake. See main.bpf.c for more info. Normally set by the power mode, but can be set independently if desired.

prefer_smt_core: bool

Schedule tasks on SMT siblings before using other physcial cores when core compaction is enabled. Normally set by the power mode, but can be set independently if desired.

prefer_little_core: bool

Schedule tasks on little (efficiency) cores before big (performance) cores when core compaction is enabled. Normally set by the power mode, but can be set independently if desired.

no_prefer_turbo_core: bool

Do not specifically prefer to schedule on turbo cores. Normally set by the power mode, but can be set independently if desired.

no_freq_scaling: bool

Disable controlling the CPU frequency. In order to improve latency and responsiveness of performance-critical tasks, scx_lavd increases the CPU frequency even if CPU usage is low. See main.bpf.c for more info. Normally set by the power mode, but can be set independently if desired.

stats: Option<f64>

Enable stats monitoring with the specified interval.

monitor: Option<f64>

Run in stats monitoring mode with the specified interval. Scheduler is not launched.

monitor_sched_samples: Option<u64>

Run in monitoring mode. Show the specified number of scheduling samples every second.

verbose: u8

Enable verbose output, including libbpf details. Specify multiple times to increase verbosity.

version: bool

Print scheduler version and exit.

help_stats: bool

Show descriptions for statistics.

Implementations

impl Opts

pub(crate) fn autopilot_allowed(&self) -> bool

pub(crate) fn proc(&mut self) -> Option<&mut Self>

Trait Implementations

impl Args for Opts

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 Opts

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 Opts

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

Formats the value using the given formatter.

impl FromArgMatches for Opts

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 Opts

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.