rajamesandClaude Opus 5.5
7aed588f78
docs/CLAUDE.md Phase 2, 2026-10-14. All moves by git mv; every archived file carries a header saying what it is, why, and where to look instead. - docs/reference/ (new): roadmap and versioning policy, M7.1, word-ACL design, kernel args, hosted acceptance test, dictionary, primitives, ontology, L8 table -- previously spread over docs/, docs/lithosananke/ and docs/03-architecture/. - docs/working/archive/historical/: finished work (session plan, test-gap audit, birthing plan, fix write-ups, the January architecture draft). - docs/working/archive/superseded/: the Hermes-VM Tripod docs and July Hermes designs (-> FABRIC-3.5/3.6), the StarForth roadmap, every working doc already flagged superseded or obsolete. - docs/working/archive/dead/: the hal_* target contract (never adopted), L4Re, metrics-and-knobs. - Papers and proposals into docs/working/papers/. - References rewritten across the repo (not logs/, not docs/patent/); CLAUDE.md's documentation section rewritten. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
60 lines
2.4 KiB
TeX
60 lines
2.4 KiB
TeX
%% Vol II, Chapter 4 — Platform Support
|
|
%% SOURCE: docs/working/scratch/src/platform-integration/ (multiple .adoc files)
|
|
%% docs/working/archive/dead/hal-target-contract/ (HAL design — aspirational)
|
|
%% .claude/CLAUDE.md (Platform abstraction, build targets)
|
|
|
|
\chapter{Platform Support}
|
|
\label{vol2:chap:platforms}
|
|
|
|
%% TODO(bob): intro paragraph listing the three supported execution contexts:
|
|
%% 1. Hosted (Linux, POSIX)
|
|
%% 2. L4Re / Fiasco.OC microkernel
|
|
%% 3. Bare metal via LithosAnanke (amd64, aarch64, riscv64)
|
|
|
|
\section{Linux / Hosted}
|
|
\label{vol2:sec:platforms:linux}
|
|
|
|
%% SOURCE: src/platform/linux/time.c, .claude/CLAUDE.md
|
|
%% TODO(bob): describe POSIX timing, standard build, and the hosted execution path.
|
|
|
|
\section{L4Re / Fiasco.OC}
|
|
\label{vol2:sec:platforms:l4re}
|
|
|
|
%% SOURCE: docs/working/scratch/src/platform-integration/L4RE_INTEGRATION.adoc
|
|
%% docs/working/scratch/src/platform-integration/l_4_re_blkio_endpoints.adoc
|
|
%% TODO(bob): describe the L4Re integration: IPC, dataspaces, package structure,
|
|
%% and the blkio vtable API. Note that the malloc/free → L4Re-native allocator
|
|
%% migration (dictionary_management.c) is still pending.
|
|
|
|
\section{Bare Metal: amd64}
|
|
\label{vol2:sec:platforms:amd64}
|
|
|
|
%% SOURCE: .claude/CLAUDE.md (src/starkernel/arch/amd64/)
|
|
%% TODO(bob): describe the amd64 kernel path: arch.c, apic.c, timer.c,
|
|
%% interrupts.c, boot.S, isr.S.
|
|
|
|
\section{Bare Metal: aarch64 and riscv64}
|
|
\label{vol2:sec:platforms:arm-riscv}
|
|
|
|
%% SOURCE: docs/working/scratch/src/platform-integration/RASPBERRY_PI_BUILD.adoc
|
|
%% TODO(bob): describe aarch64 (Raspberry Pi 4) and riscv64 targets.
|
|
%% QEMU-based validation for all three arches.
|
|
|
|
\section{Platform Abstraction Layer (HAL Target)}
|
|
\label{vol2:sec:platforms:hal}
|
|
|
|
%% SOURCE: docs/working/archive/dead/hal-target-contract/overview.md
|
|
%% IMPORTANT: the hal_* API described in the hal/ doc family is the TARGET
|
|
%% design, not the current codebase. Current code uses sf_time_backend_t-style
|
|
%% naming. This section describes the planned migration.
|
|
%% TODO(bob): review hal/migration-plan.md and decide whether to describe
|
|
%% the current state, the target, or both (with clear labeling).
|
|
|
|
\section{Raspberry Pi Build}
|
|
\label{vol2:sec:platforms:rpi}
|
|
|
|
%% SOURCE: docs/working/scratch/src/performance-profiling/ARM64_OPTIMIZATIONS.adoc
|
|
\begin{lstlisting}[language=bash, caption={Raspberry Pi cross-compilation}]
|
|
make rpi4-cross # Cross-compile for Raspberry Pi 4 (ARM64)
|
|
\end{lstlisting}
|