Document original x86 startup allocation handover #98

Open
erikinkinen wants to merge 14 commits from feature/x86-startup-resource-contract into feature/counted-boot-object-names
Owner

Describe BootKernel v2.1 startup storage: the exact header extension and resource offsets, original allocation/reservation requirements, and retention through uncertain AP startup. Keep wire validation distinct from actual native ownership and multicore acceptance.

Depends on #90. Implements the manual portion of lib-handoff #8, alongside lib-handoff #9. The matching bootloader and native kernel work remains separate.

  • Exact v2.1 wire layout and strict version migration.
  • Original resource ownership, reservation coverage and uncertain startup duties.
  • Include the chapter in the owned manual source inventory.
  • Complete warning-free manual build and inspect the affected PDF pages.

This branch also includes the completed downstream features from #99, #100, #101, #102.

Describe BootKernel v2.1 startup storage: the exact header extension and resource offsets, original allocation/reservation requirements, and retention through uncertain AP startup. Keep wire validation distinct from actual native ownership and multicore acceptance. Depends on [#90](https://git.erikinkinen.fi/erix/docs/pulls/90). Implements the manual portion of [lib-handoff #8](https://git.erikinkinen.fi/erix/lib-handoff/issues/8), alongside [lib-handoff #9](https://git.erikinkinen.fi/erix/lib-handoff/pulls/9). The matching bootloader and native kernel work remains separate. - [x] Exact v2.1 wire layout and strict version migration. - [x] Original resource ownership, reservation coverage and uncertain startup duties. - [x] Include the chapter in the owned manual source inventory. - [x] Complete warning-free manual build and inspect the affected PDF pages. This branch also includes the completed downstream features from #99, #100, #101, #102.
docs: Specify original x86 startup allocation handover
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m16s
58187e7d35
Describe the BootKernel v2.1 extension, exact wire offsets and reservation checks. Keep descriptive metadata distinct from original native ownership, including uncertain AP startup and final-root admission.
erikinkinen added this to the Alpha 1 milestone 2026-11-13 08:18:13 +01:00
erikinkinen changed title from WIP: Document original x86 startup allocation handover to Document original x86 startup allocation handover 2026-11-13 08:32:18 +01:00
Author
Owner

The manual contract is ready for review. The complete manual builds and the new wire tables, version text and ownership cross-reference have been inspected in the PDF. The matching bootloader and kernel implementation remains tracked separately in lib-handoff#8.

The manual contract is ready for review. The complete manual builds and the new wire tables, version text and ownership cross-reference have been inspected in the PDF. The matching bootloader and kernel implementation remains tracked separately in lib-handoff#8.
docs: specify counted processor topology and its authority boundary
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m12s
251e44650c
Document the exact BootKernel 2.1 and 2.2 extension matrix, immutable ID descriptor, transactional encoder and separate source capture, BSP and native startup duties. Preserve the original startup slot and register the new manual source for bounded reproducible rendering.
docs: Merge counted processor topology data
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 5s
CI / manual (push) Successful in 5m20s
c29e1b8c59
Specify counted processor topology data. Integrate the reviewed feature into feature/x86-startup-resource-contract while the upstream work retains its own completion requirements.

#99
docs: specify original loaded runtime image boundaries
Some checks failed
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / manual (push) Failing after 1m35s
dba9954257
Document the exact BootKernel 2.3 image and segment tables, whole-allocation custody and precise mapping policy. Keep original handover ownership, cache admission and actual native enforcement separate from metadata validation.
fix: use the manual inline typeface for runtime contracts
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m4s
e8fbfabe8b
Use the existing texttt command for protocol fields and APIs so the new contract builds within the shared manual preamble.
docs: require compatible initialization of shared runtime bytes
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m14s
8d0fe2fc35
Make the producer source-byte obligation explicit for overlapping loaded spans; wire metadata cannot establish agreement between file bytes and zero-fill.
fix: number the runtime contract and render cache bits explicitly
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m4s
b86e488a4b
Use the peer subsection level so cross-references identify the runtime contract itself. Express the cache index arithmetically to avoid TeX ligatures changing shift operators.
docs: Merge loaded runtime image custody
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 5s
CI / manual (push) Successful in 5m27s
e4c377be1d
Specify loaded runtime image custody. Integrate the reviewed feature into feature/x86-startup-resource-contract while the upstream work retains its own completion requirements.

#100
docs: Specify the explicit Kernel runtime provider contract
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m12s
e36540961a
Describe exact runtime-export selection, loaded-definition checks and coordinated producer compatibility. Keep authenticated link policy separate from original image allocation custody and execution authority.
docs: Merge document the Kernel compiler-runtime provider
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 5m30s
7d457efe9b
Document the Kernel compiler-runtime provider. Integrate the reviewed feature into feature/x86-startup-resource-contract while the upstream work retains its own completion requirements.

#101
docs: Specify original runtime-image root source lifetimes
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m11s
91e7cb97d8
Connect the loaded-image handover to exact supervisor allowlists, original processor policy, independent file-reader retirement and closed framebuffer conversion. Keep source controls separate from native multicore image acceptance.
docs: Merge document original runtime-image root source lifetimes
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 5s
CI / manual (push) Successful in 5m26s
21285725b5
Document original runtime-image root source lifetimes. Integrate the reviewed feature into feature/x86-startup-resource-contract while the upstream work retains its own completion requirements.

#102
Author
Owner

Merged the approved downstream work from #99, #100, #101, #102. The upstream PR retains its own remaining scope and completion requirements.

Merged the approved downstream work from #99, #100, #101, #102. The upstream PR retains its own remaining scope and completion requirements.
docs: Specify fixed PCI assignment handover and source boundaries
All checks were successful
CI / markdown (push) Successful in 4s
CI / manual (push) Successful in 4m14s
b1223b4a47
Document the exact BootKernel 2.4 tables, mixed-width BAR identities and multiple assigned extents. Separate metadata validation from original platform takeover, final controller confirmation and physical resource lifetime, including protected framebuffer and DMA boundaries.
docs: Merge specify original fixed PCI resource handover
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / manual (push) Successful in 4m7s
63b28db195
Integrate the reviewed prepared history into feature/x86-startup-resource-contract. The feature tree and
original source branch remain unchanged. Upstream work retains its own
completion requirements.

#103
All checks were successful
CI / manual (pull_request) Has been skipped
CI / markdown (pull_request) Has been skipped
CI / markdown (push) Successful in 3s
CI / manual (push) Successful in 4m7s
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin 'feature/x86-startup-resource-contract:feature/x86-startup-resource-contract'
git switch 'feature/x86-startup-resource-contract'

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch 'feature/counted-boot-object-names'
git merge --no-ff 'feature/x86-startup-resource-contract'
git switch 'feature/x86-startup-resource-contract'
git rebase 'feature/counted-boot-object-names'
git switch 'feature/counted-boot-object-names'
git merge --ff-only 'feature/x86-startup-resource-contract'
git switch 'feature/x86-startup-resource-contract'
git rebase 'feature/counted-boot-object-names'
git switch 'feature/counted-boot-object-names'
git merge --no-ff 'feature/x86-startup-resource-contract'
git switch 'feature/counted-boot-object-names'
git merge --squash 'feature/x86-startup-resource-contract'
git switch 'feature/counted-boot-object-names'
git merge --ff-only 'feature/x86-startup-resource-contract'
git switch 'feature/counted-boot-object-names'
git merge 'feature/x86-startup-resource-contract'
git push origin 'feature/counted-boot-object-names'
Sign in to join this conversation.
No description provided.