Struct Filesystem 

pub struct Filesystem { /* private fields */ }

RAII wrapper around an ext2_filsys handle.

Drop flushes and closes the filesystem, preventing resource leaks even when operations fail or panic.

Example

use std::path::Path;
use bux_e2fs::{Filesystem, CreateOptions};

let mut fs = Filesystem::create(
    Path::new("/tmp/image.raw"),
    512 * 1024 * 1024,
    &CreateOptions::default(),
).unwrap();
fs.populate(Path::new("/tmp/rootfs")).unwrap();
fs.add_journal().unwrap();
// Drop closes the filesystem automatically.

Implementations

impl Filesystem

pub fn create( path: &Path, size_bytes: u64, opts: &CreateOptions, ) -> Result<Self>

Creates a new ext4 filesystem image at path.

Equivalent to mke2fs -t ext4 -b <block_size> -m <reserved> <path> <size>.

pub fn open(path: &Path) -> Result<Self>

Opens an existing ext4 image for read-write operations.

pub fn populate(&mut self, source_dir: &Path) -> Result<()>

Populates the filesystem from a host directory.

Recursively copies all files, directories, symlinks, and permissions from source_dir into the image root.

pub fn flush(&mut self) -> Result<()>

Flushes all pending changes to disk without closing the filesystem.

pub fn write_file(&mut self, host_path: &Path, guest_path: &str) -> Result<()>

Writes a single host file into the filesystem image.

Equivalent to debugfs -w -R "write <host_path> <guest_path>".

pub fn mkdir(&mut self, name: &str) -> Result<()>

Creates a directory inside the filesystem image.

pub fn symlink(&mut self, name: &str, target: &str) -> Result<()>

Creates a symlink inside the filesystem image.

pub fn add_journal(&mut self) -> Result<()>

Adds an ext3/4 journal (size auto-calculated by libext2fs).

pub fn link( &mut self, dir: u32, name: &str, ino: u32, file_type: FileType, ) -> Result<()>

Creates a directory entry linking name to inode ino in directory dir.

pub fn read_inode(&self, ino: u32) -> Result<ext2_inode>

Reads the on-disk inode structure for the given inode number.

pub fn write_inode(&mut self, ino: u32, inode: &ext2_inode) -> Result<()>

Writes the inode structure back to the filesystem.

pub fn write_new_inode(&mut self, ino: u32, inode: &ext2_inode) -> Result<()>

Writes a freshly allocated inode (initializes the on-disk slot).

pub fn alloc_inode(&mut self, dir: u32, mode: u16) -> Result<u32>

Allocates a new inode number near dir with the given POSIX mode.

Updates the inode bitmap and allocation statistics automatically. Requires bitmaps to be loaded (always true after create).

pub fn alloc_block(&mut self, goal: u64) -> Result<u64>

Allocates a new block near goal.

Updates the block bitmap and allocation statistics automatically. Requires bitmaps to be loaded (always true after create).

Trait Implementations

impl Debug for Filesystem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for Filesystem

fn drop(&mut self)

Executes the destructor for this type.