38 lines
1.5 KiB
Markdown
38 lines
1.5 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)
|
|||
|
|
|
|||
|
|
- Build: `lang/build/build_runner.sh` → produces `lang/bin/hakorune`
|
|||
|
|
- Requirements: LLVM 18 dev (`llvm-config-18`)
|
|||
|
|
- Run: `lang/bin/hakorune`
|
|||
|
|
|
|||
|
|
Notes
|
|||
|
|
- The launcher is minimal and prints a stable line `[lang-launcher] hello`.
|
|||
|
|
- This binary is a stepping stone towards a full selfhosted CLI built from Hakorune scripts.
|
|||
|
|
|