[FEATURE] Implement original independent FAT directory anchors #12

Closed
opened 2026-10-01 09:42:20 +02:00 by erikinkinen · 0 comments
Owner

Problem and motivation

Vfsd prepares independent root/cwd scopes through the existing conditional provider-anchor protocol. Fatd currently implements mounted-root acquisition and component custody but not the independent-anchor operation. Completing object-based cwd and launch/exact/redirection migration requires original directory cloning with its own lifetime and an explicit navigation ceiling.

Proposed behavior and scope

Implement the existing FsProviderAcquireAnchorRequestV1 family in Fatd without changing wire layouts. Consume fresh original source evidence, reserve a mount-scoped cleanup key and counted row before publication, and clone the same actual directory independently of its source handle. An optional held ceiling permits bounded parent navigation; omission narrows the clone to the source directory itself.

Selected catalogs prove actual ancestry by original serials. Imported media uses original retained directory chains where those prove the selected ceiling; absent proof must refuse without a pathname or mounted-root fallback. Share parent selection, directory observations and ordinary-custody admission. Update original root retirement to retain all dependent ceilings and retry keys.

Authority, security and reliability

The original startup provider/storage route remains the only authority. Directory names, serials, mount IDs and permission fields do not select a new route. Both source and explicit ceiling must be actual live directories on that original mount. Freshness is one-use; replay fences never reset. Clones do not inherit source cleanup ownership. Bound descendants retain their exact original ceiling; its retirement disables ordinary use before waiting for descendants. Lost replies retire by original mount/key independently of source liveness. Unknown cleanup preserves disabled custody and the existing fail-stop boundary.

Acceptance criteria

Checklist
  • Implement exact existing private request/reply framing with complete output capacity before effects.
  • Implement independent source clones, explicit ceiling admission, original root clamping and current-parent traversal across moves and detachment.
  • Keep cleanup available after source retirement, reject replay/stale/foreign or incomplete evidence, and count ceiling dependencies through failed or repeated retirement.
  • Cover selected FAT/exFAT and imported retained ancestry with authored provider/transport controls, including capacity, read-only media, source reuse and cancellation-shaped original-key cleanup.
  • Update inline/component/manual contracts and publish coherent signed immutable revisions with exact issue/review tracking.

Full compatibility cwd migration and guest self-hosting remain separate unfinished requirements.

Alternatives and tradeoffs

Reopening the source spelling cannot preserve original identity through moves or removal. Promoting a bounded current directory to the mounted root would widen authority. Original catalog ancestry supports selected formats without a depth ceiling; imported media requires counted retained ancestry and keeps its existing mutation guards. Deployment storage limits remain explicit capacity outcomes rather than hidden fallback behavior.

Tracking and rollout

Prerequisite within the namespace/lifetime feature, building on current parent observations. Provider review, Integration review, phase requirements. Keep legacy spelling guards until all Vfsd consumers are migrated; this provider operation alone does not close the full cwd/lifetime criteria.

Current independent FAT directory anchors — 1 October 2026

Imported clones copy only required retained ancestors below their ceiling, carrying no source cleanup keys or broader original roots.

Full Vfsd cwd/launch/exact/redirection migration and complete cross-provider lifetime remain open; legacy spelling guards stay until their consumers migrate.

Both full EriX guest build generations and external Rust/LLVM rebuilding remain required and unperformed.

Related records and contracts
Repository Links
docs PR 4
fatd issue 12, native-namespace.md
## Problem and motivation Vfsd prepares independent root/cwd scopes through the existing conditional provider-anchor protocol. Fatd currently implements mounted-root acquisition and component custody but not the independent-anchor operation. Completing object-based cwd and launch/exact/redirection migration requires original directory cloning with its own lifetime and an explicit navigation ceiling. ## Proposed behavior and scope Implement the existing `FsProviderAcquireAnchorRequestV1` family in Fatd without changing wire layouts. Consume fresh original source evidence, reserve a mount-scoped cleanup key and counted row before publication, and clone the same actual directory independently of its source handle. An optional held ceiling permits bounded parent navigation; omission narrows the clone to the source directory itself. Selected catalogs prove actual ancestry by original serials. Imported media uses original retained directory chains where those prove the selected ceiling; absent proof must refuse without a pathname or mounted-root fallback. Share parent selection, directory observations and ordinary-custody admission. Update original root retirement to retain all dependent ceilings and retry keys. ## Authority, security and reliability The original startup provider/storage route remains the only authority. Directory names, serials, mount IDs and permission fields do not select a new route. Both source and explicit ceiling must be actual live directories on that original mount. Freshness is one-use; replay fences never reset. Clones do not inherit source cleanup ownership. Bound descendants retain their exact original ceiling; its retirement disables ordinary use before waiting for descendants. Lost replies retire by original mount/key independently of source liveness. Unknown cleanup preserves disabled custody and the existing fail-stop boundary. ## Acceptance criteria <details> <summary>Checklist</summary> - [x] Implement exact existing private request/reply framing with complete output capacity before effects. - [x] Implement independent source clones, explicit ceiling admission, original root clamping and current-parent traversal across moves and detachment. - [x] Keep cleanup available after source retirement, reject replay/stale/foreign or incomplete evidence, and count ceiling dependencies through failed or repeated retirement. - [x] Cover selected FAT/exFAT and imported retained ancestry with authored provider/transport controls, including capacity, read-only media, source reuse and cancellation-shaped original-key cleanup. - [x] Update inline/component/manual contracts and publish coherent signed immutable revisions with exact issue/review tracking. Full compatibility cwd migration and guest self-hosting remain separate unfinished requirements. </details> ## Alternatives and tradeoffs Reopening the source spelling cannot preserve original identity through moves or removal. Promoting a bounded current directory to the mounted root would widen authority. Original catalog ancestry supports selected formats without a depth ceiling; imported media requires counted retained ancestry and keeps its existing mutation guards. Deployment storage limits remain explicit capacity outcomes rather than hidden fallback behavior. ## Tracking and rollout Prerequisite within [the namespace/lifetime feature](https://git.erikinkinen.fi/erix/posixd/issues/27), building on [current parent observations](https://git.erikinkinen.fi/erix/fatd/issues/11). [Provider review](https://git.erikinkinen.fi/erix/fatd/pulls/3), [Integration review](https://git.erikinkinen.fi/erix/integration/pulls/12), [phase requirements](https://git.erikinkinen.fi/erix/integration/issues/65). Keep legacy spelling guards until all Vfsd consumers are migrated; this provider operation alone does not close the full cwd/lifetime criteria. ### Current independent FAT directory anchors — 1 October 2026 Imported clones copy only required retained ancestors below their ceiling, carrying no source cleanup keys or broader original roots. Full Vfsd cwd/launch/exact/redirection migration and complete cross-provider lifetime remain open; legacy spelling guards stay until their consumers migrate. Both full EriX guest build generations and external Rust/LLVM rebuilding remain required and unperformed. <details> <summary>Related records and contracts</summary> | Repository | Links | | --- | --- | | docs | [PR 4](https://git.erikinkinen.fi/erix/docs/pulls/4) | | fatd | [issue 12](https://git.erikinkinen.fi/erix/fatd/issues/12), [native-namespace.md](https://git.erikinkinen.fi/erix/fatd/src/branch/feature/posix-compat/docs/native-namespace.md) | </details>
erikinkinen added this to the Alpha 1 milestone 2026-10-30 09:34:00 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
erix/fatd#12
No description provided.