entropyfs 0.7.13

Entropy-native Linux filesystem: persist irreducible state, materialize structure, preserve exact bytes.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

//! # EntropyFS
//!
//! Entropy-native Linux filesystem: **persist irreducible state, materialize
//! structure, preserve exact bytes, measure everything.**
//!
//! This crate is the entire EntropyFS implementation — one package, one
//! architectural source tree (see `docs/adr/0001-single-crate.md`).
//!
//! # Safety
//!
//! `#![forbid(unsafe_code)]` applies to every module in the crate, with
//! ONE designated exception: `platform::io_uring` (the io_uring submission
//! ring is kernel-shared memory; pushing an SQE is inherently `unsafe`).
//! The crate root carries `#![deny(unsafe_code)]` as the backstop, and a
//! test walks `src/` asserting the set of files containing `unsafe` equals
//! the ledger's file list (`docs/security/unsafe-ledger.md`).
#![deny(unsafe_code)]
#![deny(rust_2018_idioms)]
#![warn(missing_docs)]

// Core: pure deterministic representation algebra. Knows nothing about
// FUSE, disk, or DSFB.
pub mod core;

// Mathematical/configurational storage machinery (rank/unrank, universes,
// transforms, residuals).
pub mod entropy;

// Thin adaptation layer over the `ryg-rans-rs` dependency.
pub mod rans;

// Storage-specific DSFB observer (zero decoding authority).
pub mod dsfb;

// Phase 12E.1: the stable embeddable storage-engine facade (content-
// addressed blobs over the persistent store; FUSE/ublk/Engine API are
// peers above the same store).
pub mod engine;

// Phase 12E.14: the stable C ABI — the opaque-handle facade over the
// engine (ledger-designated unsafe file; see docs/security/unsafe-ledger.md).
pub mod ffi;

// Permanent on-disk format: explicit little-endian byte codecs.
pub mod format;

// Crash-consistent persistent immutable object store.
pub mod store;

// Linux POSIX/VFS adapter (FUSE). No entropy algorithms here. Phase
// 12E.2: compiled only with the `fuse` feature.
#[cfg(feature = "fuse")]
pub mod fuse;

// Representation search and migration.
pub mod optimizer;

// Bounded performance-only caches.
pub mod cache;

// Integrity primitives: logical content, physical record, root.
pub mod integrity;

// Independent validation and repair.
pub mod fsck;

// Evidence: casefiles, receipts, manifests.
pub mod evidence;

// Narrowly isolated Linux-specific machinery.
pub mod platform;

// Phase-10A performance instrumentation (diagnostic; never affects
// correctness or persistence).
pub mod perf;

// Experimental ublk block-device frontend (Phase 7; requires root +
// CONFIG_BLK_DEV_UBLK to run; the BlockStore adapter is kernel-free).
// Phase 12E.2: compiled only with the `ublk` feature.
#[cfg(feature = "ublk")]
pub mod ublk;

#[cfg(test)]
mod tests;