fstool 0.4.14

Build disk images and filesystems (ext2/3/4, MBR, GPT) from a directory tree and TOML spec, in the spirit of genext2fs.
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

//! `cpio` archives as an fstool filesystem.
//!
//! Covers the two portable ASCII variants:
//!
//! - **newc** (`070701`) and **newc-crc** (`070702`) — 110-byte
//!   hex-ASCII headers, 4-byte-aligned name + body.
//! - **odc** (`070707`) — 76-byte octal-ASCII headers, no padding.
//!
//! The binary `cpio` variants (`0x71c7` / byte-swapped) are out of
//! scope. Reads cover all file types (regular, dir, symlink, device,
//! fifo); the writer emits **newc**. Hard links are read as independent
//! files (the link relationship is not reconstructed).

mod scan;
mod write;

use crate::Result;
use crate::block::BlockDevice;
use crate::fs::archive::ArchiveFs;

/// newc header magic.
pub const MAGIC_NEWC: &[u8; 6] = b"070701";
/// newc-with-CRC header magic.
pub const MAGIC_NEWC_CRC: &[u8; 6] = b"070702";
/// odc (old portable) header magic.
pub const MAGIC_ODC: &[u8; 6] = b"070707";
/// End-of-archive sentinel name.
pub const TRAILER: &str = "TRAILER!!!";
/// POSIX file-type mask (`S_IFMT`).
pub const S_IFMT: u32 = 0o170000;

/// Format options for `cpio` (none today).
#[derive(Debug, Clone, Default)]
pub struct CpioFormatOpts;

impl CpioFormatOpts {
    pub fn apply_options(&mut self, _bag: &mut crate::format_opts::OptionMap) -> Result<()> {
        Ok(())
    }
}

/// `cpio` filesystem handle.
pub struct CpioFs(pub ArchiveFs);

impl CpioFs {
    pub fn open(dev: &mut dyn BlockDevice) -> Result<Self> {
        Ok(Self(ArchiveFs::from_index(scan::scan(dev)?)))
    }

    pub fn format(dev: &mut dyn BlockDevice, _opts: &CpioFormatOpts) -> Result<Self> {
        Ok(Self(ArchiveFs::writer(
            "cpio",
            Box::new(write::CpioWriter::new(dev)),
        )))
    }
}

impl crate::fs::FilesystemFactory for CpioFs {
    type FormatOpts = CpioFormatOpts;
    fn format(dev: &mut dyn BlockDevice, opts: &Self::FormatOpts) -> Result<Self> {
        Self::format(dev, opts)
    }
    fn open(dev: &mut dyn BlockDevice) -> Result<Self> {
        Self::open(dev)
    }
}

crate::impl_archive_fs_filesystem!(CpioFs);