Struct Ext4Fs 

pub struct Ext4Fs { /* private fields */ }

An ext4 filesystem instance.

This is the main entry point for filesystem operations. Create an instance by mounting a block device, then use the various methods to manipulate files and directories.

Example

use ext4_lwext4::{Ext4Fs, FileBlockDevice, OpenFlags};

// Open a disk image and mount
let device = FileBlockDevice::open("disk.img").unwrap();
let fs = Ext4Fs::mount(device, false).unwrap();

// Create a directory
fs.mkdir("/data", 0o755).unwrap();

// Write a file (use a block to ensure file is dropped before umount)
{
    let mut file = fs.open("/data/hello.txt", OpenFlags::CREATE | OpenFlags::WRITE).unwrap();
    // ... write operations ...
}

// Unmount when done
fs.umount().unwrap();

Implementations

impl Ext4Fs

pub fn mount<B: BlockDevice + 'static>( device: B, read_only: bool, ) -> Result<Self>

Mount an ext4 filesystem from a block device.

Arguments

• device - The block device containing the filesystem
• read_only - Whether to mount read-only

Returns

A mounted Ext4Fs instance

pub fn umount(self) -> Result<()>

Unmount the filesystem.

This flushes all pending writes and releases the block device.

pub fn is_read_only(&self) -> bool

Check if filesystem is mounted read-only.

pub fn stat(&self) -> Result<FsStats>

Get filesystem statistics.

pub fn open(&self, path: &str, flags: OpenFlags) -> Result<File<'_>>

Open a file.

Arguments

• path - Path to the file
• flags - Open flags (READ, WRITE, CREATE, etc.)

pub fn open_dir(&self, path: &str) -> Result<Dir<'_>>

Open a directory for iteration.

pub fn mkdir(&self, path: &str, mode: u32) -> Result<()>

Create a directory.

Arguments

• path - Path for the new directory
• mode - Permissions (e.g., 0o755)

pub fn remove(&self, path: &str) -> Result<()>

Remove a file.

pub fn rmdir(&self, path: &str) -> Result<()>

Remove a directory (recursively).

pub fn rename(&self, from: &str, to: &str) -> Result<()>

Rename a file or directory.

pub fn link(&self, src: &str, dst: &str) -> Result<()>

Create a hard link.

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

Create a symbolic link.

Arguments

• target - The path the symlink points to
• path - Path for the new symlink

pub fn readlink(&self, path: &str) -> Result<String>

Read the target of a symbolic link.

pub fn exists(&self, path: &str) -> bool

Check if a path exists.

pub fn is_file(&self, path: &str) -> bool

Check if a path exists and is a file.

pub fn is_dir(&self, path: &str) -> bool

Check if a path exists and is a directory.

pub fn metadata(&self, path: &str) -> Result<Metadata>

Get file metadata.

pub fn set_permissions(&self, path: &str, mode: u32) -> Result<()>

Set file permissions.

pub fn set_owner(&self, path: &str, uid: u32, gid: u32) -> Result<()>

Set file owner.

pub fn sync(&self) -> Result<()>

Flush all pending writes to disk.

Trait Implementations

impl Drop for Ext4Fs

fn drop(&mut self)

Executes the destructor for this type.