Files
erofs-freebsd-out-tree/docs/capabilities.md
T
2026-08-13 10:44:59 +02:00

66 lines
3.6 KiB
Markdown

# repo-pre-2 Capability Record
## Status Vocabulary
This document separates inherited pre1 claims from fresh pre2 validation:
- `INHERITED CLAIM`: documented by the unchanged pre1 snapshot; not re-tested
for pre2.
- `STATIC GATE`: visible in tracked source or build declarations; runtime
behavior was not exercised.
- `NOT IMPLEMENTED`: explicitly excluded by inherited project documentation.
- `NOT CLAIMED`: inherited documentation deliberately limits the support
claim.
- `NOT RUN`: no build or runtime validation was performed for repo-pre-2.
`INHERITED CLAIM` is provenance, not a new PASS result. Existing reports under
`tests/results/manual/` describe earlier pre1 work and must not be cited as a
fresh repo-pre-2 execution.
## Snapshot Evidence
```text
repo-pre-1 source tree: 6a5a1a49d4a4e08f6ef1155de240500e63a15365
repo-pre-2 initial tree: 6a5a1a49d4a4e08f6ef1155de240500e63a15365
src-linux reference tree: b79b9a8b62f633e887a8b99075ff9412fabd7f83
runtime validation: NOT RUN
```
The inherited claims below are transcribed at category level from `README.md`
and `docs/features.md`. They are not an independent feature review.
## Capability Matrix
| Area | Inherited pre1 claim or static declaration | Pre2 status |
| --- | --- | --- |
| Mount and metadata | Read-only mount/unmount, `statfs`, superblock checksum and bounds, compact/extended inodes, 48-bit fields | INHERITED CLAIM; NOT RUN |
| Plain data | Flat plain, flat inline, tail bounds, and logical block accounting | INHERITED CLAIM; NOT RUN |
| Chunk and devices | Chunk indexes, holes, device tables, explicit devices, and flatdev mapping | INHERITED CLAIM; NOT RUN |
| Compressed data | LZ4, MicroLZMA, DEFLATE, full/compact indexes, partial references, HEAD2, ztailpacking, and qualified fragment forms | INHERITED CLAIM; NOT RUN |
| ZSTD | Source is always listed; `WITH_ZSTDIO=1` adds `ZSTDIO`, while the default is `0` | STATIC GATE; runtime NOT RUN |
| Directories and vnode operations | Lookup, readdir, cookies, namecache, access, readlink, pathconf, pager integration, and read-only mutation rejection | INHERITED CLAIM; NOT RUN |
| Xattrs and ACLs | Inline/shared namespaces, metabox storage, long/packed prefixes, and POSIX ACL reads | INHERITED CLAIM; NOT RUN |
| NFS export | 64-bit NIDs, generation handling, and malformed/stale handle validation | INHERITED CLAIM; NOT RUN |
| Build target | `src/Makefile` rejects architectures other than `amd64` | STATIC GATE; build NOT RUN |
| Write support | Writable filesystem operations | NOT IMPLEMENTED |
| `VOP_BMAP` | Explicitly unsupported in inherited documentation | NOT IMPLEMENTED |
| Complete future-format parity | All future incompat features and every dedupe encoding | NOT CLAIMED |
| Explicit compressed-extent positive payload | Inherited documentation records only partial coverage | NOT CLAIMED; NOT RUN |
| Performance guarantees | Manual observations are not a performance contract | NOT CLAIMED |
## Interpretation Rules
1. Source presence, feature-bit definitions, or build selection do not prove a
runtime capability.
2. A pre1 manual report does not become a pre2 PASS merely because the initial
trees match.
3. Phase 1 mechanical edits must not expand or reduce this capability matrix.
4. A future status change requires recorded evidence from an actually executed
validation step.
## Current Validation Declaration
No build, QEMU execution, test script, smoke test, mount, malformed-image
probe, or performance measurement was run for this initialization. The current
repo-pre-2 runtime validation result is therefore `NOT RUN` in every category.