CUBELinux-2
a308f8422d
Implements the PDF's Package 3 with new code:
- path: bijective POSIX path <-> Czyx mapping (/c001/z002/y003/x004).
Axis-letter + 3-digit zero-padded canonical names so lexical order equals
numeric order and each coordinate has exactly one spelling. Inode IS the
packed u32 coordinate — no inode side table.
- nullspace: the PDF's 'use Null cubes for ACLs, xattrs, journaling, volume
metadata', with the Z-plane allocation fixed and documented (Z=1 volume,
Z=2 ACL, Z=3 xattr, Z=4 journal ring). ACL/xattr tables are FNV
hash-bucketed with exact-match resolution inside the bucket, because 4
axes of subject cannot injectively mirror into 2 axes of Null space.
Journal is a bounded ring; wraps are detectable via a monotonic counter.
- vfs: the whole filesystem, kernel-free and unit-testable — lookup,
readdir, create/read/write/truncate/unlink, mkdir/rmdir, ACL enforcement,
xattrs, journaling, POSIX errno mapping.
- fuse (feature 'mount'): thin kernel adapter, zero TTL (the store is
writable out-of-band, so cached metadata would go stale).
- cubestore: added the PDF's 'optional scanning primitives' (keys,
scan_prefix) and the Package 2 association API (associate, linked_to)
that cubefs needs for directory listings.
Two defects were found by LIVE MOUNT testing and fixed, not by unit tests:
1. mkdir succeeded then the kernel's revalidating lookup returned ENOENT,
so 'mkdir -p' could never reach depth 4. Directories were purely
inferred from records, making an empty directory unrepresentable. Fixed
with an explicit Null-space directory marker; rmdir removes it; readdir
merges markers in. 5 regression tests added.
2. Multi-user ACL behaviour was untestable because the mount lacked
AllowOther — the kernel returned EACCES at the mountpoint before any
request reached us. Added --allow-other.
Verified: 58 unit tests pass; clippy clean; live mount exercised with cat,
echo, dd, truncate, cp, chmod, chown, getfattr/setfattr, mkdir -p, rmdir,
find, a 200-record write loop, and cross-user reads/writes as luulu.
26 lines
798 B
TOML
26 lines
798 B
TOML
[package]
|
|
name = "cubefs"
|
|
version = "0.1.0"
|
|
edition.workspace = true
|
|
license.workspace = true
|
|
description = "POSIX/FUSE namespace over the CUBELinux CZYX coordinate space (PDF Package 3)"
|
|
|
|
[dependencies]
|
|
cubecoords = { path = "../cubecoords" }
|
|
cubestore = { path = "../cubestore" }
|
|
fuser = { version = "0.16", optional = true }
|
|
libc = { version = "0.2", optional = true }
|
|
|
|
[features]
|
|
# Decision: the FUSE adapter is behind a feature so the pure mapping/ACL/
|
|
# journal logic (the part that must be correct) can be built and tested on any
|
|
# machine without libfuse3 or a mountable /dev/fuse. `--features mount` pulls
|
|
# in fuser and the kernel-facing adapter.
|
|
default = []
|
|
mount = ["dep:fuser", "dep:libc"]
|
|
|
|
[[bin]]
|
|
name = "cubefs-mount"
|
|
path = "src/bin/cubefs_mount.rs"
|
|
required-features = ["mount"]
|