Struct Cli 

pub struct Cli {
    pub command: Commands,
    pub verbose: bool,
    pub config: Option<PathBuf>,
    pub cpu_threads: Option<usize>,
    pub io_threads: Option<usize>,
    pub storage_type: Option<String>,
    pub channel_depth: usize,
}

Main CLI structure

Fields

command: Commands

verbose: bool

Enable verbose logging

config: Option<PathBuf>

Configuration file path

cpu_threads: Option<usize>

Override CPU worker thread count

Controls the number of concurrent CPU-bound operations (compression, encryption). Default: num_cpus - 1 (reserves 1 core for I/O and coordination)

Educational: Setting this too high causes thrashing, too low wastes cores. Monitor CPU saturation metrics to tune appropriately.

io_threads: Option<usize>

Override I/O worker thread count

Controls the number of concurrent I/O operations (file reads/writes). Default: Device-specific (NVMe: 24, SSD: 12, HDD: 4)

Educational: This should match your storage device’s queue depth for optimal throughput. Check –storage-type if auto-detection is incorrect.

storage_type: Option<String>

Specify storage device type for I/O optimization

Affects default I/O thread count if –io-threads not specified. Values: nvme (queue depth 24), ssd (12), hdd (4) Default: auto-detect based on filesystem characteristics

Educational: Different storage devices have different optimal queue depths. NVMe handles more concurrent I/O than SSD, which handles more than HDD.

channel_depth: usize

Channel depth for pipeline stages (Reader → Workers → Writer)

Controls backpressure in the three-stage pipeline architecture. Default: 4

Educational: Lower values reduce memory usage but may cause stalls. Higher values increase buffering but consume more memory. Optimal value depends on chunk processing time and I/O latency.

Example: If chunk processing = 2ms and I/O = 1ms, depth=4 keeps pipeline full.

Trait Implementations

impl Args for Cli

fn group_id() -> Option<Id>

Report the 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 Clone for Cli

fn clone(&self) -> Cli

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl CommandFactory for Cli

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 Cli

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

Formats the value using the given formatter.

impl FromArgMatches for Cli

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 Cli

fn parse() -> Self

Parse from std::env::args_os(), 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 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 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.