[FEATURE] Add the native boot-image backend and exact-output publisher #6
Labels
No labels
alpha-1
bug
ci
docs
duplicate
enhancement
help wanted
invalid
performance
phase-6
question
refactor
security
wontfix
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set
Reference
erix/boot-tool#6
Loading…
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Problem and motivation
An EriX-hosted build needs to construct, inspect and verify boot images with
native
boot-tool. The shared command already separates parsing and image logicfrom effects, but only the Linux backend currently implements the complete file
and stream contract.
Proposed behavior and scope
Implement the native backend and executable over shared EriX clients. Preserve
all build, inspect, validate, verify, extraction and signing-payload behavior,
including raw path bytes, input order and deterministic successful artifacts.
Keep the Linux command and its existing build recipes usable.
Publication must create an exclusive adjacent temporary, write all bytes, confirm
file synchronization, close the writer and atomically replace the selected
destination. The existing exact-entry rename refuses an occupied destination;
the native publisher therefore needs a coherent replacement contract rather
than a path-based workaround. Prefer a reusable exact-output publication owner
shared with other build tools. Coordinate its admission and provider semantics
before assigning new wire operations.
Authority, security and reliability
Prepare the original arguments before binding authority. Bind only the selected
command's original read objects, output publications and inherited streams.
Paths, environment values and numeric coordinates cannot discover or widen a
namespace. Read-only commands receive no publisher. Use the original allocation
region and checked startup inventory, with no libc or host execution fallback.
A publication owner binds the original parent, destination and exclusive
temporary. It may publish only that output and remove only its own unpublished
temporary. Existing file-write rights must not silently acquire namespace
replacement rights. Preserve request, generation, partial-progress and actual
persistence evidence through close, commit and retirement.
Retain the first operation error separately from cleanup uncertainty. Never
replay an accepted prefix or uncertain rename, remove the destination after an
uncertain commit, or exit while unresolved owners survive only in local storage.
Drain positively or transfer exact custody to an authenticated surviving owner;
otherwise remain alive holding it. Payload and image are separate ordered
commits. No ordinary invocation opens a private signing key: detached signing
and explicitly selected public-key verification remain unchanged.
Acceptance criteria
order and deterministic native error-detail contract.
close and atomic replacement through an exact retained output owner.
cancellation, uncertain sync/rename and independent cleanup failures without
replay, stale-owner reuse or destination deletion.
preserve final drain or authenticated custody transfer before exit.
add bounded matching-image guest workloads with read and publication refusal.
identical valid, empty, large and malformed inputs; preserve detached signing.
strict checks and existing Linux CI free of warnings.
Alternatives and tradeoffs
A read-only native port leaves image construction outside EriX. Reopening the
temporary by name after closing it loses its original publication custody.
Giving the tool general directory mutation rights would expose more authority
than one output needs. A shared retained publisher keeps this boundary explicit;
its provider work must preserve actual replacement and persistence semantics.
Tracking and rollout
Coordinate Boot-tool PR 2 and
Integration PR 12.
Reuse the shared native clients developed for
native SHA-2.
Land coherent admission, client and provider changes before adopting the native
executable in build images. Keep Linux parity and actual guest acceptance as
separate required results.
The command-specific broker contract is tracked in Launchd issue 26. Launchd will validate exact prepared operation, class, selector and lifetime rows against the original manifest, script and session ceilings. The native client must retire its broader original sender before ordinary effects; inspect and verify retain only their selected reads. Publication remains a distinct admitted operation with its own original transaction custody.
57ca22b3retains each selected file operand’s original argv index during the sole parse. Reads and publications keep their raw bytes and distinct occurrences when execution order differs from option order. Native admission can bind that footprint without reparsing or searching for equal paths. The existing path-only visitor remains a projection of the same records. The manual chapter describes the binding contract.