erix/lib-bootstrap
1
0
Fork 0
generated from erix/meta
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
lib-bootstrap defines shared bootstrap startup contracts for root task and early critical services.
29 commits 1 branch 0 tags 180 KiB
  • Rust 100%
Find a file
Exact
Erik Inkinen d842b74dd9
All checks were successful
CI / test (push) Successful in 5s
Details
CI / security (push) Successful in 1m34s
Details
CI / minimal-versions (push) Successful in 11s
Details
lib-bootstrap: drop unstable rustfmt options for stable toolchains
2026-03-23 10:19:53 +02:00
.github Refactor milestone terminology to "Component Milestone Tracking" across documentation for clarity and consistency 2026-03-05 11:54:11 +02:00
src boot-config: add validation_profile=none for runtime images 2026-03-17 04:27:29 +02:00
tests Add fixture-based tests for envelope parsing and validation 2026-02-27 05:46:13 +02:00
.editorconfig Initial commit 2026-02-27 04:14:06 +01:00
.gitignore Initial commit 2026-02-27 04:14:06 +01:00
ARCHITECTURE.md boot-config: add validation_profile=none for runtime images 2026-03-17 04:27:29 +02:00
Cargo.toml Update dependencies to use Git sources for lib-capabi and lib-ipc 2026-03-03 13:17:59 +02:00
CODE_OF_CONDUCT.md Initial commit 2026-02-27 04:14:06 +01:00
CONTRIBUTING.md Refactor milestone terminology to "Component Milestone Tracking" across documentation for clarity and consistency 2026-03-05 11:54:11 +02:00
LICENSE Initial commit 2026-02-27 04:14:06 +01:00
README.md boot-config: add validation_profile=none for runtime images 2026-03-17 04:27:29 +02:00
ROADMAP.md boot-config: add validation_profile=none for runtime images 2026-03-17 04:27:29 +02:00
rustfmt.toml lib-bootstrap: drop unstable rustfmt options for stable toolchains 2026-03-23 10:19:53 +02:00
SECURITY.md docs: align security policy phase numbering 2026-03-11 05:28:12 +02:00

README.md

lib-bootstrap

lib-bootstrap defines shared bootstrap startup contracts for root task and early critical services.

This repository provides startup envelope schemas and role constants layered on shared capability and IPC primitives.

It also defines the BootConfig payload wire contract used by rootd to drive runtime service and driver orchestration from boot.img.

Scope

lib-bootstrap is responsible for:

  • root->service startup envelope types/constants
  • service role IDs and startup flag constants
  • BootConfigHeaderV1 / BootConfigEntryV1 payload contracts
  • boot-config launch-kind / flag / validation-profile constants
  • readiness/failure status code contracts for bootstrap phase
  • checked parse/encode helpers for startup messages

lib-bootstrap is not responsible for:

  • launch ordering policy
  • retry/backoff policy
  • service lifecycle management outside startup contract
  • capability policy (owned by root/service logic)

Relationship to Other Repos

  • complements lib-handoff (handoff chain structs) for the root->services phase
  • references capability descriptor types from lib-capabi
  • may embed IPC header usage from lib-ipc
  • consumed by rootd and early service repos (memd, pagerd, procd, vspaced)

Design Constraints

  • No external crates.
  • Versioned, strict startup envelope validation.
  • Deterministic parse/validation behavior.
  • No policy in shared helpers.

Status

Implemented baseline.

Current crate includes RootServiceStartEnvelopeV1, split-role constants for memd/vspaced/pagerd/procd, strict parse/validation helpers, optional IPC framing integration, BootConfig parse/encode/validate helpers (including validation_profile=none for runtime images), and fixture-based tests.

License

ISC.