Jan De Landtsheer
3d14f77516
* choose ESP matching the primary data disk when multiple ESPs exist, falling back gracefully for single-disk layouts * keep new helper to normalize device names and reuse the idempotent mount logic * apply cargo fmt across the tree
115 lines
4.1 KiB
Rust
115 lines
4.1 KiB
Rust
// REGION: API
|
|
// api: cli::LogLevelArg { Error, Warn, Info, Debug }
|
|
// api: cli::Cli { config: Option<String>, log_level: LogLevelArg, log_to_file: bool, fstab: bool, force: bool }
|
|
// api: cli::from_args() -> crate::cli::Cli
|
|
// REGION: API-END
|
|
//
|
|
// REGION: RESPONSIBILITIES
|
|
// - Define non-interactive CLI flags mirroring kernel cmdline semantics.
|
|
// - Provide a stable parsing entry (from_args) suitable for initramfs.
|
|
// Non-goals: config validation, IO, or side effects beyond parsing.
|
|
// REGION: RESPONSIBILITIES-END
|
|
//
|
|
// REGION: EXTENSION_POINTS
|
|
// ext: add --dry-run to support planning without changes (future).
|
|
// ext: add --report-path to override JSON report location (future).
|
|
// REGION: EXTENSION_POINTS-END
|
|
//
|
|
// REGION: SAFETY
|
|
// safety: no interactive prompts; default values are explicit; parsing errors should be clear.
|
|
// REGION: SAFETY-END
|
|
//
|
|
// REGION: ERROR_MAPPING
|
|
// errmap: clap parsing errors are emitted by clap; higher layers should handle exit strategy.
|
|
// REGION: ERROR_MAPPING-END
|
|
//
|
|
// REGION: TODO
|
|
// todo: consider hidden/unstable flags gated by build features for developers.
|
|
// REGION: TODO-END
|
|
//! CLI definition mirroring kernel cmdline semantics; non-interactive.
|
|
|
|
use clap::{Parser, ValueEnum};
|
|
|
|
#[derive(Debug, Clone, Copy, ValueEnum)]
|
|
#[value(rename_all = "kebab_case")]
|
|
pub enum LogLevelArg {
|
|
Error,
|
|
Warn,
|
|
Info,
|
|
Debug,
|
|
}
|
|
|
|
impl std::fmt::Display for LogLevelArg {
|
|
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
|
let s = match self {
|
|
LogLevelArg::Error => "error",
|
|
LogLevelArg::Warn => "warn",
|
|
LogLevelArg::Info => "info",
|
|
LogLevelArg::Debug => "debug",
|
|
};
|
|
f.write_str(s)
|
|
}
|
|
}
|
|
|
|
//// Using crate::types::Topology (ValueEnum) directly for CLI parsing to avoid duplication.
|
|
// TopologyArg enum removed; CLI field uses crate::types::Topology
|
|
|
|
/// zosstorage - one-shot disk initializer for initramfs.
|
|
#[derive(Debug, Parser)]
|
|
#[command(name = "zosstorage", disable_help_subcommand = true)]
|
|
pub struct Cli {
|
|
/// DEPRECATED: external YAML configuration is not used at runtime (ADR-0002). Ignored with a warning.
|
|
#[arg(short = 'c', long = "config", hide = true)]
|
|
pub config: Option<String>,
|
|
|
|
/// Log level: error, warn, info, debug
|
|
#[arg(short = 'l', long = "log-level", value_enum, default_value_t = LogLevelArg::Info)]
|
|
pub log_level: LogLevelArg,
|
|
|
|
/// Also log to /run/zosstorage/zosstorage.log
|
|
#[arg(short = 'L', long = "log-to-file", default_value_t = false)]
|
|
pub log_to_file: bool,
|
|
|
|
/// Enable writing /etc/fstab entries
|
|
#[arg(short = 's', long = "fstab", default_value_t = false)]
|
|
pub fstab: bool,
|
|
|
|
/// Select topology (CLI has precedence over kernel cmdline)
|
|
#[arg(short = 't', long = "topology", value_enum)]
|
|
pub topology: Option<crate::types::Topology>,
|
|
|
|
/// Present but non-functional; returns unimplemented error
|
|
#[arg(short = 'f', long = "force")]
|
|
pub force: bool,
|
|
|
|
/// Include removable devices (e.g., USB sticks) during discovery (default: false)
|
|
#[arg(long = "allow-removable", default_value_t = false)]
|
|
pub allow_removable: bool,
|
|
|
|
/// Attempt to mount existing filesystems based on on-disk headers; no partitioning or mkfs.
|
|
/// Non-destructive mounting flow; uses UUID= sources and policy from config.
|
|
#[arg(long = "mount-existing", default_value_t = false)]
|
|
pub mount_existing: bool,
|
|
|
|
/// Report current initialized filesystems and mounts without performing changes.
|
|
#[arg(long = "report-current", default_value_t = false)]
|
|
pub report_current: bool,
|
|
|
|
/// Print detection and planning summary as JSON to stdout (non-default)
|
|
#[arg(long = "show", default_value_t = false)]
|
|
pub show: bool,
|
|
|
|
/// Write detection/planning JSON report to the given path
|
|
#[arg(long = "report")]
|
|
pub report: Option<String>,
|
|
|
|
/// Execute destructive actions (apply mode). When false, runs preview-only.
|
|
#[arg(long = "apply", default_value_t = false)]
|
|
pub apply: bool,
|
|
}
|
|
|
|
/// Parse CLI arguments (non-interactive; suitable for initramfs).
|
|
pub fn from_args() -> Cli {
|
|
Cli::parse()
|
|
}
|