btrfs-cli 0.12.0

User-space command-line tool for inspecting and managing Btrfs filesystems
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

use super::{
    PropertyObjectType, detect_object_types, property_description,
    property_names,
};
use crate::{RunContext, Runnable};
use anyhow::{Result, anyhow, bail};
use clap::Parser;
use std::path::PathBuf;

/// List available properties with their descriptions for the given object
#[derive(Parser, Debug)]
pub struct PropertyListCommand {
    /// Btrfs object path to list properties for
    pub object: PathBuf,

    /// Object type (inode, subvol, filesystem, device)
    #[clap(short = 't', long = "type")]
    pub object_type: Option<PropertyObjectType>,
}

impl Runnable for PropertyListCommand {
    fn run(&self, _ctx: &RunContext) -> Result<()> {
        // Detect object type if not specified
        let detected_types = detect_object_types(&self.object);
        let target_type = if let Some(t) = self.object_type {
            t
        } else {
            // If ambiguous, require the user to specify
            if detected_types.len() > 1 {
                bail!(
                    "object type is ambiguous, please use option -t (detected: {detected_types:?})"
                );
            }
            detected_types
                .first()
                .copied()
                .ok_or_else(|| anyhow!("object is not a btrfs object"))?
        };

        for name in property_names(target_type) {
            println!("{:<20}{}", name, property_description(name));
        }

        Ok(())
    }
}