Repository files navigation

Idiomatic Rust API for thelittlefs microcontroller filesystem byChris Haster.

Number2 refers to the on-disk format version,supporting inline files, custom attributes and dynamic wear-leveling.

We followstd::fs as much as reasonable.

The low-level bindings are provided by thelittlefs2-sys library.

The core types that are independent of a specific implementation version are provided by thelittlefs2-core crate, see thecore directory. These types are re-exported from thelittlefs2 crate too.

Upstream release:v2.9.3

This library isno_std compatible, but there are two gotchas.

• The dev-dependencymemchr oflittlefs2-sys has itsstd features activated. To prevent this, upgrade to at least Rust 1.51and addresolver = "2" in the consuming code's[package] section. This will be the default in Rust 2021 edition.

• At link time,lfs.c has a dependency onstrcpy. When not linking to alibc with this symbol, activate thec-stubs featureto provide an implementation.

^{littlefs is licensed underBSD-3-Clause.This API for littlefs is licensed under either ofApache License, Version 2.0 orMIT License at your option.Previous bindings exist in therust-littlefs repository, also dual-licensed under Apache-2.0 and MIT.}
_{Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.}