Struct ext4_view::Ext4

pub struct Ext4 { /* private fields */ }

Read-only access to an ext4 filesystem.

Implementations

impl Ext4

pub fn load(reader: Box<dyn Ext4Read>) -> Result<Self, Ext4Error>

Load an Ext4 instance from the given reader.

This reads and validates the superblock and block group descriptors. No other data is read.

pub fn load_from_path(path: &Path) -> Result<Self, Ext4Error>

Available on crate feature std only.

Load an Ext4 filesystem from the given path.

This reads and validates the superblock and block group descriptors. No other data is read.

impl Ext4

These methods mirror the std::fs API.

pub fn canonicalize<'p, P>(&self, path: P) -> Result<PathBuf, Ext4Error>

where P: TryInto<Path<'p>>,

Get the canonical, absolute form of a path with all intermediate components normalized and symbolic links resolved.

Errors

An error will be returned if:

• path is not absolute.
• path does not exist.

pub fn read<'p, P>(&self, path: P) -> Result<Vec<u8>, Ext4Error>

where P: TryInto<Path<'p>>,

Read the entire contents of a file as raw bytes.

Errors

An error will be returned if:

• path is not absolute.
• path does not exist.
• path is a directory or special file type.

pub fn read_to_string<'p, P>(&self, path: P) -> Result<String, Ext4Error>

where P: TryInto<Path<'p>>,

Read the entire contents of a file as a string.

Errors

An error will be returned if:

• path is not absolute.
• path does not exist.
• path is a directory or special file type.

pub fn read_link<'p, P>(&self, path: P) -> Result<PathBuf, Ext4Error>

where P: TryInto<Path<'p>>,

Get the target of a symbolic link.

The final component of path must be a symlink. If the path contains any symlinks in components prior to the end, they will be fully resolved as normal.

Errors

An error will be returned if:

• path is not absolute.
• The final component of path is not a symlink.

pub fn read_dir<'p, P>(&self, path: P) -> Result<ReadDir<'_>, Ext4Error>

where P: TryInto<Path<'p>>,

Get an iterator over the entries in a directory.

Errors

An error will be returned if:

• path is not absolute.
• path does not exist
• path is not a directory

pub fn exists<'p, P>(&self, path: P) -> Result<bool, Ext4Error>

where P: TryInto<Path<'p>>,

Check if path exists.

Returns Ok(true) if path exists, or Ok(false) if it does not exist.

Errors

An error will be returned if:

• path is not absolute.

pub fn metadata<'p, P>(&self, path: P) -> Result<Metadata, Ext4Error>

where P: TryInto<Path<'p>>,

Get Metadata for path.

Errors

An error will be returned if:

• path is not absolute.
• path does not exist.