lamfold-romfs 0.0.1

no_std clean-room Linux romfs (-rom1fs-) reader — the lamfold minimal-embedded frontend
Documentation
  • Coverage
  • 100%
    2 out of 2 items documented0 out of 0 items with examples
  • Size
  • Source code size: 16.47 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 330.89 kB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 10s Average build duration of successful builds.
  • all releases: 10s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Homepage
  • lamco-admin/lamfold
    1 0 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • glamberson

lamfold-romfs

The romfs frontend of the lamfold read-only media stack — clean-room Linux romfs (-rom1fs-).

Reads over a lamfold::BlockSource and implements lamfold::FoldFrontend. romfs is the minimal uncompressed read-only filesystem for tiny embedded and early-boot images — the floor of the flock. Spec: the lamfold design spec §4.

Status — legacy/embedded adds

Layer State
Header (-rom1fs-, big-endian size, volume name) ✅ done + tested
File headers (16-byte aligned; next low-3-bits = type, info, size) ✅ done + tested
Directory next-chain (info = first child; ./.. skipped) ✅ done + tested
Regular files (uncompressed, contiguous) ✅ done + tested
Symlinks via read_link ✅ done + tested

Complete. Verified against a real genromfs image: probe, tree walk, files (full + partial + EOF), a nested directory, and a symlink. Builds default + --no-default-features (no_std), clippy -D warnings clean, #![forbid(unsafe_code)] — every field read big-endian through bounds-checked helpers.

Clean-room posture

Derived only from the kernel romfs format docs. The GPL-2 fs/romfs driver is fenced off. neotron-romfs is a different, incompatible format and GPL-3 — deliberately not consulted (a trap noted in the SDS landscape).

Build / test

cargo build
cargo test                                   # walks tests/fixtures/romfs.img
cargo build --no-default-features            # no_std check

MIT OR Apache-2.0.