Struct trussed::store::Fs

pub struct Fs<S: 'static + LfsStorage> { /* private fields */ }

Implementations

impl<S: 'static + LfsStorage> Fs<S>

pub fn new(fs: &'static Filesystem<'static, S>) -> Self

Methods from Deref<Target = Filesystem<'static, S>>

pub fn total_blocks(&self) -> usize

Total number of blocks in the filesystem

pub fn total_space(&self) -> usize

Total number of bytes in the filesystem

pub fn available_blocks(&self) -> Result<usize, Error>

Available number of unused blocks in the filesystem

Upstream littlefs documentation notes (on its “current size” function): “Result is best effort. If files share COW structures, the returned size may be larger than the filesystem actually is.”

So it would seem that there are at least the number of blocks returned by this method available, at any given time.

pub fn available_space(&self) -> Result<usize, Error>

Available number of unused bytes in the filesystem

This is a lower bound, more may be available. First, more blocks may be available as explained in available_blocks. Second, files may be inlined.

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

Remove a file or directory.

pub fn remove_dir(&self, path: &Path) -> Result<(), Error>

Remove a file or directory.

pub fn remove_dir_all(&self, path: &Path) -> Result<(), Error>

TODO: This method fails if some println! calls are removed. Whyy?

pub fn remove_dir_all_where<P>(
    &self,
    path: &Path,
    predicate: &P
) -> Result<usize, Error> where
    P: Fn(&DirEntry) -> bool, 

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

Rename or move a file or directory.

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

Given a path, query the filesystem to get information about a file or directory.

To read user attributes, use Filesystem::attribute

pub fn create_file_and_then<R>(
    &self,
    path: &Path,
    f: impl FnOnce(&File<'_, '_, Storage>) -> Result<R, Error>
) -> Result<R, Error>

pub fn open_file_and_then<R>(
    &self,
    path: &Path,
    f: impl FnOnce(&File<'_, '_, Storage>) -> Result<R, Error>
) -> Result<R, Error>

pub fn open_file_with_options_and_then<R>(
    &self,
    o: impl FnOnce(&mut OpenOptions) -> &OpenOptions,
    path: &Path,
    f: impl FnOnce(&File<'_, '_, Storage>) -> Result<R, Error>
) -> Result<R, Error>

pub fn attribute(&self, path: &Path, id: u8) -> Result<Option<Attribute>, Error>

Read attribute.

pub fn remove_attribute(&self, path: &Path, id: u8) -> Result<(), Error>

Remove attribute.

pub fn set_attribute(
    &self,
    path: &Path,
    attribute: &Attribute
) -> Result<(), Error>

Set attribute.

pub fn read_dir_and_then<R>(
    &self,
    path: &Path,
    f: impl FnOnce(&mut ReadDir<'_, '_, Storage>) -> Result<R, Error>
) -> Result<R, Error>

pub unsafe fn read_dir(
    &'b self,
    alloc: &'b mut ReadDirAllocation,
    path: &Path
) -> Result<ReadDir<'a, 'b, Storage>, Error>

Returns a pseudo-iterator over the entries within a directory.

This is unsafe since it can induce UB just like File::open.

pub fn create_dir(&self, path: &Path) -> Result<(), Error>

Creates a new, empty directory at the provided path.

pub fn create_dir_all(&self, path: &Path) -> Result<(), Error>

Recursively create a directory and all of its parent components if they are missing.

pub fn read<const N: usize>(&self, path: &Path) -> Result<Vec<u8, N>, Error>

Read the entire contents of a file into a bytes vector.

pub fn write(&self, path: &Path, contents: &[u8]) -> Result<(), Error>

Write a slice as the entire contents of a file.

This function will create a file if it does not exist, and will entirely replace its contents if it does.

Trait Implementations

impl<S: 'static + LfsStorage> Deref for Fs<S>

type Target = Filesystem<'static, S>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.