puzzlefs-lib 0.2.0

Build, mount and extract PuzzleFS images.
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
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

extern crate fuser as fuse_ffi;

use std::path::Path;

use crate::format::Result;
use crate::oci::Image;

mod puzzlefs;
pub use puzzlefs::PuzzleFS;
pub use puzzlefs::PUZZLEFS_IMAGE_MANIFEST_VERSION;

pub mod fuse;
pub use fuse::Fuse;

mod walk;
use fuse::PipeDescriptor;
pub use walk::WalkPuzzleFS;

// copied from the fuser function 'MountOption::from_str' because it's not exported
fn mount_option_from_str(s: &str) -> fuse_ffi::MountOption {
    match s {
        "auto_unmount" => fuse_ffi::MountOption::AutoUnmount,
        "allow_other" => fuse_ffi::MountOption::AllowOther,
        "allow_root" => fuse_ffi::MountOption::AllowRoot,
        "default_permissions" => fuse_ffi::MountOption::DefaultPermissions,
        "dev" => fuse_ffi::MountOption::Dev,
        "nodev" => fuse_ffi::MountOption::NoDev,
        "suid" => fuse_ffi::MountOption::Suid,
        "nosuid" => fuse_ffi::MountOption::NoSuid,
        "ro" => fuse_ffi::MountOption::RO,
        "rw" => fuse_ffi::MountOption::RW,
        "exec" => fuse_ffi::MountOption::Exec,
        "noexec" => fuse_ffi::MountOption::NoExec,
        "atime" => fuse_ffi::MountOption::Atime,
        "noatime" => fuse_ffi::MountOption::NoAtime,
        "dirsync" => fuse_ffi::MountOption::DirSync,
        "sync" => fuse_ffi::MountOption::Sync,
        "async" => fuse_ffi::MountOption::Async,
        x if x.starts_with("fsname=") => fuse_ffi::MountOption::FSName(x[7..].into()),
        x if x.starts_with("subtype=") => fuse_ffi::MountOption::Subtype(x[8..].into()),
        x => fuse_ffi::MountOption::CUSTOM(x.into()),
    }
}

pub fn mount<T: AsRef<str>>(
    image: Image,
    tag: &str,
    mountpoint: &Path,
    options: &[T],
    init_notify: Option<PipeDescriptor>,
    manifest_verity: Option<&[u8]>,
) -> Result<()> {
    let pfs = PuzzleFS::open(image, tag, manifest_verity)?;
    let fuse = Fuse::new(pfs, None, init_notify);
    fuse_ffi::mount2(
        fuse,
        mountpoint,
        &options
            .iter()
            .map(|option| mount_option_from_str(option.as_ref()))
            .collect::<Vec<_>>(),
    )?;
    Ok(())
}

pub fn spawn_mount<T: AsRef<str>>(
    image: Image,
    tag: &str,
    mountpoint: &Path,
    options: &[T],
    init_notify: Option<PipeDescriptor>,
    sender: Option<std::sync::mpsc::Sender<()>>,
    manifest_verity: Option<&[u8]>,
) -> Result<fuse_ffi::BackgroundSession> {
    let pfs = PuzzleFS::open(image, tag, manifest_verity)?;
    let fuse = Fuse::new(pfs, sender, init_notify);
    Ok(fuse_ffi::spawn_mount2(
        fuse,
        mountpoint,
        &options
            .iter()
            .map(|option| mount_option_from_str(option.as_ref()))
            .collect::<Vec<_>>(),
    )?)
}