trickfs: add trickmnt

Cargo.toml

@@ -1,6 +1,14 @@
 [workspace]
 resolver = "2"
-members = ["core", "nomt", "fuzz", "torture", "examples/*", "trickfs"]
+members = [
+    "core",
+    "nomt",
+    "fuzz",
+    "torture",
+    "examples/*",
+    "trickfs",
+    "trickfs/trickmnt",
+]
 exclude = ["benchtop"]
 
 [workspace.package]

README.md

@@ -25,6 +25,7 @@ NOMT: Project Root.
 |--<a href="./nomt">nomt</a>: Implementation of the NOMT database.
 |──<a href="./torture">torture</a>: Extensive testing suite for NOMT.
 |--<a href="./trickfs">trickfs</a>: A FUSE filesystem aiding deeper testing. Experimental.
+│   ├──<a href="./trickfs/trickmnt">trickmnt</a>: A tool that allows mounting trickfs.
 </pre>
 
 ## Architecture

trickfs/Cargo.toml

@@ -8,8 +8,10 @@ edition.workspace = true
 license.workspace = true
 
 [dependencies]
-env_logger = "0.11.6"
 fuser = { version = "0.15.1", features = ["abi-7-23"] }
 libc = "0.2.169"
 log = "0.4.22"
 tempfile = "3.15.0"
+
+[dev-dependencies]
+env_logger = "0.11.6"

trickfs/README.md

@@ -2,6 +2,16 @@
 
 A FUSE filesystem useful for failure injection.
 
+# Using trickfs.
+
+Typically you would not need to run trickfs directly, because it should be used as a dependency
+in other projects. However, if you want to test the filesystem, you can do so by running the
+following command:
+
+```sh
+cargo run --release --bin trickmnt
+```
+
 # Building
 
 Building the project requires fuse3 and fuse to be available. On Ubuntu, you can install them with

trickfs/trickmnt/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "trickmnt"
+version = "0.1.0"
+authors.workspace = true
+homepage.workspace = true
+repository.workspace = true
+edition.workspace = true
+license.workspace = true
+
+[dependencies]
+trickfs = { path = ".." }
+clap = { version = "4.3.5", features = ["derive"] }
+env_logger = "0.11.6"
+log = "0.4.22"
+anyhow = "1.0.95"

trickfs/trickmnt/src/main.rs

@@ -0,0 +1,28 @@
+use clap::Parser;
+
+#[derive(Parser, Debug)]
+#[command(author, version, about, long_about = None)]
+struct Args {
+    /// Path to the directory where trickfs will be mounted
+    #[arg(short, long, default_value = "/tmp/trick")]
+    mountpoint: String,
+}
+
+fn waitline() {
+    log::info!("press return to stop...");
+    let _ = std::io::stdin().read_line(&mut String::new());
+}
+
+fn main() -> anyhow::Result<()> {
+    env_logger::builder()
+        .filter_level(log::LevelFilter::Info)
+        .init();
+
+    let args = Args::parse();
+
+    let handle = trickfs::spawn_trick(args.mountpoint).unwrap();
+    waitline();
+    drop(handle);
+
+    Ok(())
+}