Retain original x86 startup allocation descriptions #9

Manually merged
erikinkinen merged 7 commits from feature/x86-startup-resource-handoff into main 2026-11-14 18:39:31 +01:00
Owner

Summary and rationale

Describe the original x86 boot allocations needed to retain the initial hierarchy and start APs safely. BootKernel v2.1 adds an optional extension while preserving the 200-byte base header and counted catalog.

Tracking and scope

Related: #8 and Kernel native execution.

  • Allocation-free record codec, exact geometry and metadata checks.

  • Complete bootloader reservation coverage and malformed-input controls.

  • Component contracts and exact wire offsets.

  • Technical manual contract in Docs #98.

Architecture, authority and failure behavior

The record describes original table, trampoline, real-mode stack and BSP stack allocations. It grants no access. The producer and kernel retain the actual allocations, including uncertain AP startup. Validation rejects overlapping metadata, incompatible versions, unknown flags, incomplete resources, overflow and reservation gaps. Encoding refuses invalid values before changing output. KernelRoot v1.2 is unchanged; BootKernel producers and consumers must migrate together under the existing strict version policy.

Validation evidence

Formatting, strict Clippy, all 23 tests in debug and release, warning-denied rustdoc and Markdown lint pass. These are wire-contract checks; native startup acceptance remains open above.

Review checklist

  • Original implementation; no dependencies or unsafe code added.

  • Signed commit, inline rustdoc and source files below 1,000 lines.

  • README, ARCHITECTURE and ROADMAP updated.

  • Encode and validate the original x86 startup allocation descriptions.

Native producer/consumer acceptance: Bootloader #29, Kernel #139.

This branch also includes the completed downstream features from #11, #13.

## Summary and rationale Describe the original x86 boot allocations needed to retain the initial hierarchy and start APs safely. BootKernel v2.1 adds an optional extension while preserving the 200-byte base header and counted catalog. ## Tracking and scope Related: #8 and [Kernel native execution](https://git.erikinkinen.fi/erix/kernel/issues/11). - [x] Allocation-free record codec, exact geometry and metadata checks. - [x] Complete bootloader reservation coverage and malformed-input controls. - [x] Component contracts and exact wire offsets. - [x] Technical manual contract in [Docs #98](https://git.erikinkinen.fi/erix/docs/pulls/98). ## Architecture, authority and failure behavior The record describes original table, trampoline, real-mode stack and BSP stack allocations. It grants no access. The producer and kernel retain the actual allocations, including uncertain AP startup. Validation rejects overlapping metadata, incompatible versions, unknown flags, incomplete resources, overflow and reservation gaps. Encoding refuses invalid values before changing output. KernelRoot v1.2 is unchanged; BootKernel producers and consumers must migrate together under the existing strict version policy. ## Validation evidence Formatting, strict Clippy, all 23 tests in debug and release, warning-denied rustdoc and Markdown lint pass. These are wire-contract checks; native startup acceptance remains open above. ## Review checklist - [x] Original implementation; no dependencies or unsafe code added. - [x] Signed commit, inline rustdoc and source files below 1,000 lines. - [x] README, ARCHITECTURE and ROADMAP updated. - [x] Encode and validate the original x86 startup allocation descriptions. Native producer/consumer acceptance: [Bootloader #29](https://git.erikinkinen.fi/erix/bootloader/pulls/29), [Kernel #139](https://git.erikinkinen.fi/erix/kernel/pulls/139). This branch also includes the completed downstream features from #11, #13.
feat: Describe original x86 startup allocations in the boot handoff
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 2s
CI / test (push) Successful in 22s
a4bbe1a24f
Carry checked table, trampoline, real-mode stack and BSP stack descriptions in BootKernel v2.1. Keep allocation ownership with the producer and native consumer; decoded physical addresses cannot create a startup loan.
erikinkinen added this to the Alpha 1 milestone 2026-11-13 07:49:18 +01:00
erikinkinen changed title from WIP: Retain original x86 startup allocation descriptions to Retain original x86 startup allocation descriptions 2026-11-13 20:16:40 +01:00
Author
Owner

The codec tests cover exact wire framing, malformed/truncated layouts, reservation coverage, optional scratch and transactional encoding. Current component CI passes. Actual production and native consumption remain tracked by Bootloader #29 and Kernel #139; they do not add native authority to this data codec. Ready for review.

The codec tests cover exact wire framing, malformed/truncated layouts, reservation coverage, optional scratch and transactional encoding. Current component CI passes. Actual production and native consumption remain tracked by Bootloader #29 and Kernel #139; they do not add native authority to this data codec. Ready for review.
feat: encode counted processor topology as immutable boot data
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 2s
CI / test (push) Successful in 23s
d35f942618
Preserve the startup descriptor while accepting the exact known BootKernel 2.1 and 2.2 extension matrix. Borrow complete u32 processor IDs without allocation or native ownership claims, and preflight every existing metadata and startup range before encoding. Keep source capture, uniqueness and actual BSP matching with their defining producers and consumers.
feat: Merge define counted processor topology data
Some checks failed
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / test (push) Has been cancelled
CI / markdown (push) Has been cancelled
b5815cbbcf
Define counted processor topology data. Integrate the reviewed feature into feature/x86-startup-resource-handoff while the upstream work retains its own completion requirements.

#11
feat: describe exact loaded runtime allocations and segment policy
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 2s
CI / test (push) Successful in 23s
0fa453166f
Add the known BootKernel 2.3 runtime image extension while preserving earlier schemas. Validate complete allocation custody descriptions separately from exact segment mapping maxima; metadata, source hashes and paging selectors create no native owner.
fix: preserve empty memory-map record compatibility
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 2s
CI / test (push) Successful in 25s
696c35637c
Ignore empty memory-map entries when checking runtime allocation coverage. Empty entries carry no extent or authority and must not introduce a new rejection of otherwise valid handoffs.
docs: distinguish shared segment initialization from mapping policy
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / test (push) Successful in 26s
530cb218ad
Require the original producer to verify overlapping initialized bytes and zero-fill independently of affine backing, source hashes and permission compatibility.
feat: Merge loaded runtime image allocations
All checks were successful
CI / test (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / test (push) Successful in 31s
99b5a29780
Describe loaded runtime image allocations. Integrate the reviewed feature into feature/x86-startup-resource-handoff while the upstream work retains its own completion requirements.

#13
Author
Owner

Merged the approved downstream work from #11, #13. The upstream PR retains its own remaining scope and completion requirements.

Merged the approved downstream work from #11, #13. The upstream PR retains its own remaining scope and completion requirements.
erikinkinen manually merged commit 05ea748d5f into main 2026-11-14 18:39:31 +01:00
Sign in to join this conversation.
No description provided.