entropyfs 0.6.0

Entropy-native Linux filesystem: persist irreducible state, materialize structure, preserve exact bytes.
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! `entropyfs snapshot create <store> <name>` and `entropyfs snapshots
//! <store>`: snapshot management (ADR-0007).

#![forbid(unsafe_code)]

use std::path::PathBuf;

use crate::store::transaction::CrashHooks;
use crate::store::{Store, StoreConfig};

/// Options for `snapshot create`.
#[derive(Debug, Clone, clap::Args)]
pub struct SnapshotCreateArgs {
    /// Store directory.
    #[arg(value_name = "STORE")]
    pub store: PathBuf,
    /// Snapshot name.
    #[arg(value_name = "NAME")]
    pub name: String,
}

/// Options for `snapshot delete`.
#[derive(Debug, Clone, clap::Args)]
pub struct SnapshotDeleteArgs {
    /// Store directory.
    #[arg(value_name = "STORE")]
    pub store: PathBuf,
    /// Snapshot name.
    #[arg(value_name = "NAME")]
    pub name: String,
}

/// Options for `snapshot restore`.
#[derive(Debug, Clone, clap::Args)]
pub struct SnapshotRestoreArgs {
    /// Store directory.
    #[arg(value_name = "STORE")]
    pub store: PathBuf,
    /// Snapshot name.
    #[arg(value_name = "NAME")]
    pub name: String,
}

/// Options for `snapshots` (list).
#[derive(Debug, Clone, clap::Args)]
pub struct SnapshotsArgs {
    /// Store directory.
    #[arg(value_name = "STORE")]
    pub store: PathBuf,
}

/// Create a snapshot.
pub fn run_create(args: &SnapshotCreateArgs) -> Result<(), String> {
    let config = StoreConfig::default();
    let store = Store::open(&args.store, &config).map_err(|e| e.to_string())?;
    let entry = store
        .create_snapshot(args.name.as_bytes(), &CrashHooks::none())
        .map_err(|e| e.to_string())?;
    println!(
        "snapshot '{}' created (root {})",
        args.name,
        crate::cli::mkfs::hex_encode(entry.root_id.as_bytes())
    );
    Ok(())
}

/// List snapshots.
pub fn run_list(args: &SnapshotsArgs) -> Result<(), String> {
    let config = StoreConfig::default();
    let store = Store::open(&args.store, &config).map_err(|e| e.to_string())?;
    let snaps = store.list_snapshots().map_err(|e| e.to_string())?;
    if snaps.is_empty() {
        println!("no snapshots");
        return Ok(());
    }
    for (name, entry) in snaps {
        println!(
            "{:<32} root {}",
            String::from_utf8_lossy(&name),
            crate::cli::mkfs::hex_encode(entry.root_id.as_bytes())
        );
    }
    Ok(())
}

/// Delete a snapshot.
pub fn run_delete(args: &SnapshotDeleteArgs) -> Result<(), String> {
    crate::fsck::ensure_unmounted(&args.store)?;
    let config = StoreConfig::default();
    let store = Store::open(&args.store, &config).map_err(|e| e.to_string())?;
    let present = store
        .delete_snapshot(args.name.as_bytes(), &CrashHooks::none())
        .map_err(|e| e.to_string())?;
    if present {
        println!("snapshot '{}' deleted", args.name);
    } else {
        println!("no such snapshot '{}'", args.name);
    }
    Ok(())
}

/// Restore (roll back to) a snapshot.
pub fn run_restore(args: &SnapshotRestoreArgs) -> Result<(), String> {
    crate::fsck::ensure_unmounted(&args.store)?;
    let config = StoreConfig::default();
    let store = Store::open(&args.store, &config).map_err(|e| e.to_string())?;
    store
        .restore_snapshot(args.name.as_bytes(), &CrashHooks::none())
        .map_err(|e| e.to_string())?;
    println!("snapshot '{}' restored", args.name);
    Ok(())
}