Struct Args

pub struct Args {
    pub repeat_failure: bool,
    pub repeat_success: bool,
    pub ppid_targeting: bool,
    pub verbose: u8,
    pub random_delay: RandomDelayArgs,
    pub p2dq: SchedulerOpts,
    pub pid: Option<pid_t>,
    pub args: Vec<String>,
}

scx_chaos: A general purpose sched_ext scheduler designed to amplify race conditions

WARNING: This scheduler is a very early alpha, and hasn’t been production tested yet. The CLI in particular is likely very unstable and does not guarantee compatibility between versions.

scx_chaos is a general purpose scheduler designed to run apps with acceptable performance. It has a series of features designed to add latency in paths in an application. All control is through the CLI. Running without arguments will not attempt to introduce latency and can set a baseline for performance impact. The other command line arguments allow for specifying latency inducing behaviours which attempt to induce a crash.

Unlike most other schedulers, you can also run scx_chaos with a named target. For example: scx_chaos – ./app_that_might_crash –arg1 –arg2 In this mode the scheduler will automatically detach after the application exits, unless run with --repeat-failure where it will restart the application on failure.

Fields

repeat_failure: bool

Whether to continue on failure of the command under test.

repeat_success: bool

Whether to continue on successful exit of the command under test.

ppid_targeting: bool

Whether to focus on the named task and its children instead of the entire system. Only takes effect if pid or args provided.

verbose: u8

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

random_delay: RandomDelayArgs

p2dq: SchedulerOpts

pid: Option<pid_t>

Stop the scheduler if specified process terminates

args: Vec<String>

Program to run under the chaos scheduler

Runs a program under test and tracks when it terminates, similar to most debuggers. Note that the scheduler still attaches for every process on the system.

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<'a> From<&'a Args> for BuilderIterator<'a>

fn from(args: &'a Args) -> BuilderIterator<'a>

Converts to this type from the input type.

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.