include: one folder per subsystem, and includes that name it

Sixty-five headers sat side by side in include/, so `#include "irq.h"`
said nothing about where irq.h was or what it belonged to, and errno.h,
stat.h and fcntl.h at the top shadowed the system's for any host tool
built with -I./include. They are in folders now -- arch/ core/ fs/
dev/ gfx/ net/ uapi/ (and ldls/ for the Linux driver layer) -- and
every include names the folder, as Linux's do: "core/proc.h".

Done mechanically and checked the hard way: the kernel built from this
tree disassembles identically to the one built from the tree before
it. The full image boots, and userland is the same set of programs.
Paths in docs and comments follow; docs/guides/layout.md has a table
of what is where, and tools/fix-includes.py rewrites old-style
includes from the folders in the tree, for code written before this.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S1giNvrHTrPMPw7V6x1kQ4
This commit is contained in:
Nexoniarz 2026-10-23 15:05:12 +02:00
commit a1c965da1e
267 changed files with 1560 additions and 1440 deletions

View file

@ -11,7 +11,7 @@ metadata:
**Built 2026-08-04**, before USB, because xHCI, any NIC and virtio-gpu all
need the same three things and none of them existed.
- **`kernel/dev/irq.c` + `include/irq.h`** — `irq_register(irq, fn, arg,
- **`kernel/dev/irq.c` + `include/core/irq.h`** — `irq_register(irq, fn, arg,
name, level_low)`. `trap.c` used to be a switch listing every interrupt by
name, which cannot work for a PCI device: its line comes out of config
space at probe time, so there is no constant to write a `case` label for.
@ -19,7 +19,7 @@ need the same three things and none of them existed.
handler must recognise that its own device is idle and return.
Registration publishes an entry then bumps `n` with a barrier, so dispatch
needs no lock. `/proc/interrupts` (minor 12) shows counts and trigger mode.
- **`kernel/core/dma.c` + `include/dma.h`** — `dma_alloc(size, align)` /
- **`kernel/core/dma.c` + `include/core/dma.h`** — `dma_alloc(size, align)` /
`dma_free(p, size)` (Linux's contract: caller remembers the size). Carved
off the top of physical memory in `main.c` *before* `kinit1`, because
kalloc's free list makes no contiguity promise. x86 PCI is cache coherent