Files
LithosAnanake/kernel/linker/README.md
T
rajamesandJunie a8b70e88d3 Reorganize source tree: kernel/, v3/, v4/ split and board infrastructure
Source tree reorganization:
- Move StarForth v3 engine to v3/ (src/, include/, Makefile)
- Move kernel to kernel/ (src/, include/, linker/, Makefile)
- Create v4/ skeleton for F18-ISA golden model (DECOMPOSITION.md, JUSTIFICATION.md)
- Move FABRIC-0..4.md to docs/fabric/
- Move ONTOLOGY.md and ROADMAP.md to docs/

Board infrastructure:
- Add boards/ser5/, boards/raspi/, boards/milkv/, boards/zynq7020/
- Each board has board.mk (ISA, CPU flags, boot recipe) and README.md
- Root Makefile becomes thin dispatcher: boot_image, all, clean, docs take TARGET
- make boot_image TARGET=SER5|RASPI|MILKV builds one GPT/MBR image per board
- ZYNQ7020 target exists but stops with clear error (ARMv7 port not built yet)
- scripts/mkdiskimage.sh builds disk images for all boards

Docs pipeline:
- docs/book/ with LaTeX master (main.tex) and Makefile
- pandoc converts Markdown to LaTeX at build time
- Two Lua filters: table-widths.lua (wide tables wrap), code-breaks.lua (inline code breaks)
- make docs builds single PDF (754 pages, 0 missing characters)
- make docs TARGET=<board> adds board appendix
- build/docs/<book|board>/meta.tex stamps git commit into PDF

Bug fixes:
- 42 include paths that only worked by accident now use correct relative paths
- clang-18 hardcode replaced with configurable CC variable (fixed aarch64 build)
- Pi 5: kernel_2712.img linked at 0x80000, .bss zeroed, memory reserved
- Doxyfile, .clang-tidy, README.md, Kconfig paths updated

Verified:
- Hosted v3 build passes 1012 tests, 0 failures
- SER5 image boots in QEMU (OVMF), POST passes, K exact (65536 = Q48_ONE)
- Milk-V image boots in QEMU (OpenSBI + U-Boot + bootefi), POST passes
- make clean TARGET=<board> removes only that board and its ISA objects
- make all builds all boards, hosted v3, and docs in one run

Co-authored-by: Junie <junie@jetbrains.com>
2026-10-01 15:40:09 -04:00

24 lines
967 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# linker/
GNU ld linker scripts for the LithosAnanke UEFI kernel. Three ISAs × two
build variants (monolithic loader / split ELF kernel).
## Files
| Script | ISA | Use |
|--------|-----|-----|
| `starkernel-amd64.ld` | amd64 | Monolithic build (loader + kernel in one PE32+) |
| `starkernel-loader-amd64.ld` | amd64 | UEFI loader (split build) |
| `starkernel-loader-amd64-pe.ld` | amd64 | PE32+ format (split build) |
| `starkernel-kernel-amd64.ld` | amd64 | ELF kernel (split build) |
| `starkernel-loader-aarch64.ld` | aarch64 | UEFI loader (split build) |
| `starkernel-loader-aarch64-pe.ld` | aarch64 | PE32+ format (split build) |
| `starkernel-kernel-aarch64.ld` | aarch64 | ELF kernel (split build) |
| `starkernel-loader-riscv64.ld` | riscv64 | UEFI loader |
| `starkernel-kernel-riscv64.ld` | riscv64 | ELF kernel |
## See also
- [`Makefile.starkernel`](../Makefile.starkernel) — selects the correct script per `ARCH`
- [Project root](../README.md)