erix/lib-partition
Watch
1
0
Fork
You've already forked lib-partition
 0
generated from erix/meta
Code Issues 1 Pull requests 1 Projects Releases Packages Wiki Activity Actions
lib-partition is the no-std GPT parser used by blockd
22 commits 8 branches 0 tags 196 KiB
  • Rust 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Erik Inkinen 04c4421183
All checks were successful
CI / markdown (push) Successful in 9s
Details
CI / test (push) Successful in 25s
Details
chore: Merge native CLI development into main 
Merge the selected feature/native-cli history with an explicit two-parent commit so main retains the development lineage and the validated source snapshot. The resulting tree is identical to the selected feature commit; no dependency pins or runtime behavior are changed by this merge.

Previous main: e70a9d0d4a
Selected feature: 5034123518

Publish this integration point following the requested cross-repository merge. Preserve the feature branch and immutable dependency objects for reproducibility; do not squash, rebase or rewrite existing commits.
2026-09-12 08:28:48 +03:00
.github build: Pin dependency and CI helper source commits 2026-09-12 07:31:16 +03:00
src docs: keep generated GPT stream prose literal 2026-07-31 18:20:33 +03:00
.editorconfig Initial commit 2026-04-22 04:02:34 +02:00
.gitignore Initial commit 2026-04-22 04:02:34 +02:00
.markdownlint-cli2.yaml Tighten CI markdown policy 2026-05-22 15:10:28 +03:00
ARCHITECTURE.md feat: stream complete GPT entry arrays 2026-07-31 17:57:51 +03:00
Cargo.toml build: Pin dependency and CI helper source commits 2026-09-12 07:31:16 +03:00
CODE_OF_CONDUCT.md docs: Synchronize shared contribution and review policies 2026-09-12 06:38:18 +03:00
CONTRIBUTING.md build: Pin dependency and CI helper source commits 2026-09-12 07:31:16 +03:00
LICENSE Initial commit 2026-04-22 04:02:34 +02:00
README.md feat: stream complete GPT entry arrays 2026-07-31 17:57:51 +03:00
ROADMAP.md feat: stream complete GPT entry arrays 2026-07-31 17:57:51 +03:00
rustfmt.toml Initial commit 2026-04-22 04:02:34 +02:00
SECURITY.md docs: Synchronize shared contribution and review policies 2026-09-12 06:38:18 +03:00

README.md

lib-partition

lib-partition is the no_std GPT parser used by blockd.

EriX is a clean-room, capability-based microkernel operating system written entirely in Rust.

Technical requirements are tracked in the EriX requirements, conventions, and project documentation.

See:

  • docs for design documents, specifications, and development plans.
  • Related architecture repositories for kernel, services, libraries, drivers, and integration tooling.

Purpose of This Repository

This repository implements the EriX partition library. Its purpose in EriX is to provide reusable partition primitives and contracts to EriX components.

Functionally, it exposes the partition APIs, validation tests, and documentation used by dependent repositories. The repository keeps the implementation, interface contracts, tests, and documentation for that behavior in one reviewable ownership boundary.

The maintained responsibilities are:

  • expose the lib-partition crate API for partition behavior used by dependent components
  • validate the full declared GPT header length without a legacy-sector scratch limit
  • validate and parse complete GPT entry arrays incrementally without requiring array-sized storage
  • keep data formats, constants, and validation helpers documented and tested
  • preserve clean-room, no-external-crate implementation boundaries
  • maintain compatibility expectations for downstream repositories

Clean-Room Policy

EriX follows a strict clean-room philosophy:

  • No external source code may be copied.
  • No external Rust crates are allowed.
  • No code generation tools that embed third-party code.
  • All code must be authored within the project.

Violations will result in rejection of the contribution.

License

All EriX repositories are licensed under the ISC License.

Development Model

EriX development is modular, deterministic, reproducible, authority-explicit, security-first, and self-hosting oriented.

This repository follows the project roadmap and the validation rules documented in its own roadmap.

Parsed headers, entries, and names are validated value types. Their representation is private, and callers inspect them through read-only accessors, so invalid parser output cannot be manufactured through public fields. GptEntryArrayStreamV1 covers every format-declared entry and extension byte with the GPT CRC while retaining only the standardized 128-byte prefix crossing a chunk boundary. Stream visitors must hold provisional results until finish authenticates the complete array.

Validation

  • cargo test
  • cargo fmt
  • strict clippy with warnings denied

Governance Principles

lib-partition governance is scoped to reusable partition contracts shared by dependent repositories.

The scoped governance rules are:

  • It must expose narrow, documented APIs rather than component-specific policy.
  • It keeps wire formats, constants, parsers, and validation helpers deterministic and testable.
  • It preserves clean-room implementation boundaries and does not introduce external crate dependencies.
  • Breaking API or format changes require coordinated updates in every dependent repository.

Library Boundaries

  • lib-partition carries no runtime authority by itself; authority is held by callers that use the library.
  • The crate must not hide ambient I/O, allocation policy, or service discovery behind helper APIs.

Contact

Development occurs in EriX organization and discussions happen in issues and design documents.

No decisions are considered valid without documented rationale.

Maintainers can be reached via email: admin@erikinkinen.fi.