50 lines
2.4 KiB
Markdown
50 lines
2.4 KiB
Markdown
# Hakorune Lang Line — Rust-less Kernel (C ABI)
|
||
|
||
Scope
|
||
- This `lang/` tree hosts the script-driven C ABI kernel artifacts for Phase 20.9+.
|
||
- Goal: keep the runtime data plane callable without Rust on the hot path (Hakorune → LLVM → C ABI).
|
||
|
||
Principles
|
||
- Separation: do not mix Rust crates or cargo-specific layout under this tree.
|
||
- Ownership & ABI:
|
||
- Any `char*` returned across the ABI is owned by the callee and must be freed via `hako_mem_free()`.
|
||
- Do not mix CRT `free()` across boundaries.
|
||
- Fail‑Fast: no silent fallbacks. Missing symbols must be observable via short diagnostics.
|
||
|
||
Layout (initial)
|
||
- `c-abi/` — C shim(s) and headers for the minimal kernel surface
|
||
- `README.md` — responsibilities, build notes, platform caveats
|
||
- `include/` — public headers (mirrored or thin wrappers)
|
||
- `shims/` — libc-backed shim(s) for canaries and local testing
|
||
|
||
Build & Link (dev)
|
||
- C shim: build a shared library to satisfy symbols for the LLVM line canaries.
|
||
- Link flags example:
|
||
- Linux: `-L$(pwd)/target/release -Wl,-rpath,$(pwd)/target/release -lhako_kernel_shim`
|
||
|
||
Non‑Goals
|
||
- Plugin loader, HostBridge router, Box/Type system — kept in Rust.
|
||
|
||
## Selfhost Launcher (AOT)
|
||
|
||
### Dev line (Stage1 core – experimental)
|
||
|
||
- Dev build: `tools/selfhost/build_stage1.sh` → produces `target/selfhost/hakorune`
|
||
- Role:
|
||
- Fast iteration用の Stage1 selfhost バイナリ（Ny Executor / CLI 実験など）。
|
||
- new CLI/runner 機能はまずこちらで開発・検証する。
|
||
|
||
### Stable line (lang bin – snapshot)
|
||
|
||
- Stable binary: `lang/bin/hakorune`
|
||
- Build (pure-lang launcher, legacy bring-up):
|
||
- `lang/build/build_runner.sh` → produces `lang/bin/hakorune`
|
||
- Requirements: LLVM 18 dev (`llvm-config-18`)
|
||
- Policy（Phase 25.1 以降の想定）:
|
||
- `target/selfhost/hakorune` で十分に安定したら、その成果物を `lang/bin/hakorune` に昇格させる（手動コピー or 専用スクリプト）。
|
||
- `lang/bin/hakorune` は「last known good」の Stage1 コア EXE として扱い、配布や外部からの参照時は原則こちらを基準にする。
|
||
|
||
Notes
|
||
- `lang/` 以下は「最終的に 1 つの Stage1 コア EXE（hakorune）を構成するソース群」という前提で整理する。
|
||
- `target/selfhost/hakorune` は開発中の最新版、`lang/bin/hakorune` は安定版スナップショットという役割分担にする。
|