4cc268683d
Added feature-colocated documentation for AI agent discoverability: - core/README.md: L1 Nim logic overview - hal/README.md: L0 Zig HAL overview, exported symbols - boot/README.md: Linker scripts, memory layout Panopticum Compliance: Each folder is now self-documenting. |
||
|---|---|---|
| .. | ||
| include | ||
| README.md | ||
| cstubs.c | ||
| fiber.nim | ||
| kernel.nim | ||
| panicoverride.nim | ||
| ring.nim | ||
README.md
Rumpk Core (L1)
Language: Nim
Purpose: Architecture-agnostic kernel logic
Module Index
| File | Purpose |
|---|---|
kernel.nim |
Main entry point (kmain), fiber test |
fiber.nim |
Cooperative fiber abstraction |
ring.nim |
Lock-free Disruptor ring buffer |
panicoverride.nim |
Nim panic handler for freestanding |
Architecture Independence
This folder contains no architecture-specific code. All platform-specific
details are handled by the HAL layer (../hal/).
Compile-time architecture selection uses Nim's when defined():
when defined(amd64):
const CONTEXT_SIZE = 56
elif defined(arm64):
const CONTEXT_SIZE = 96
elif defined(riscv64):
const CONTEXT_SIZE = 112
Dependencies
- Imports
console_write,rumpk_haltfrom HAL (Zig L0) - Imports
cpu_switch_tofrom arch-specific assembly - Uses
mm:arcmemory management (no GC)
Build
Built via ../build.sh [aarch64|x86_64|riscv64]