{"id":50774674,"url":"https://github.com/roastercode/beamfs","last_synced_at":"2026-06-11T22:30:18.078Z","repository":{"id":354629240,"uuid":"1224020701","full_name":"roastercode/beamfs","owner":"roastercode","description":"beamfs - resilient filesystem (Reed-Solomon FEC on bitmap metadata, FTRFS lineage)","archived":false,"fork":false,"pushed_at":"2026-05-06T18:37:32.000Z","size":1660,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-06T20:33:23.582Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roastercode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-28T22:11:02.000Z","updated_at":"2026-05-01T22:54:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/roastercode/beamfs","commit_stats":null,"previous_names":["roastercode/beamfs"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/roastercode/beamfs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roastercode%2Fbeamfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roastercode%2Fbeamfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roastercode%2Fbeamfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roastercode%2Fbeamfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roastercode","download_url":"https://codeload.github.com/roastercode/beamfs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roastercode%2Fbeamfs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34221150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-11T22:30:17.308Z","updated_at":"2026-06-11T22:30:18.050Z","avatar_url":"https://github.com/roastercode.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# beamfs - resilient filesystem\n\n**Status: PRE-DEMO. Not for publication, not for push, not for Zenodo, not\nfor kernel.org. This tree exists to validate the recovery calculus of the\ncompanion paper before any public release.**\n\nbeamfs is the implementation successor to FTRFS. Where FTRFS reaches its\nempirical ceiling (per the FTRFS v1 Technical Report,\n[doi:10.5281/zenodo.19824442](https://doi.org/10.5281/zenodo.19824442)),\nbeamfs targets the formal recovery calculus described in the beamfs v1\nTechnical Report (under `papers/2026-04-beamfs-v1/`).\n\n## Lineage\n\nThe FTRFS name and original concept originates in:\n\n\u003e Fuchs, C.M., Langer, M., Trinitis, C. (2015).\n\u003e *FTRFS: A Fault-Tolerant Radiation-Robust Filesystem for Space Use.*\n\u003e ARCS 2015, Lecture Notes in Computer Science, vol 9017. Springer.\n\u003e DOI: \u003chttps://doi.org/10.1007/978-3-319-16086-3_8\u003e\n\nThat work was developed at TU Munich (Institute for Astronautics) in the\ncontext of the MOVE-II CubeSat mission. FTRFS v1 (Desbrieres, 2026) is an\nindependent open-source realization of the Fuchs et al. design with\ncontemporary Linux kernel infrastructure. beamfs v1 (this repository)\nextends FTRFS v1 with a formal recovery operator and a soundness theorem\n(see `papers/2026-04-beamfs-v1/paper.tex`, Theorem IV.1).\n\n## Repository layout (current)\n\n  - `*.c`, `*.h`             kernel module sources (rebadged from FTRFS v1)\n  - `mkfs.beamfs.c`          userspace mkfs tool\n  - `Kconfig`, `Makefile`    kernel module build glue\n  - `Documentation/`         design notes, threat model, roadmap, testing\n  - `tools/`                 helper scripts (decode_raf_journal.py, etc.)\n  - `papers/2026-04-beamfs-v1/`\n                             LaTeX source of the beamfs v1 paper.\n                             Build via `cd papers/2026-04-beamfs-v1 \u0026\u0026 make`.\n\n## Build (kernel module)\n\nThe reference target is the Yocto Scarthgap research image at\n`~/yocto/poky/build-qemu-arm64/`, which packages\n`recipes-kernel/beamfs/` from `~/git/yocto-hardened/`. The `~/git/beamfs/`\ntree is the canonical source; it is mirrored byte-exact under\n`yocto-hardened/recipes-kernel/beamfs/files/beamfs-0.1.0/` (lockstep).\n\nFor a host smoke-test against a Yocto-built kernel tree:\n\n```\nmake KDIR=\u003cpath-to-yocto-kernel-build\u003e\n```\n\nCompiling against the host kernel (for example Gentoo 6.18.x) is not\nsupported and is expected to fail on missing kernel APIs (such as\n`inode_state_read_once`, added in mainline 7.0).\n\n## Status flag\n\n- [ ] beamfs recovery calculus (Theorem IV.1) implemented in kernel\n- [ ] Bench M6 (corrupt-then-mount) implemented and passing\n- [ ] Bench M1/M2/M4/M5 reproducing FTRFS baseline within 5%\n- [ ] Yocto research image builds, mounts, runs benchmarks\n- [ ] Published on Zenodo\n- [ ] Published on GitHub (roastercode/beamfs)\n- [ ] Submitted to kernel.org / linux-fsdevel\n\nWhen all checkboxes are ticked, this section is removed and the README\ngets a proper public-facing introduction.\n\n## License\n\nGPL-2.0-only (kernel module + userspace tools), CC-BY-4.0 (paper).\nSee `COPYING` and `papers/2026-04-beamfs-v1/paper.tex` header.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froastercode%2Fbeamfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froastercode%2Fbeamfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froastercode%2Fbeamfs/lists"}