This section documents the Valecium kernel implementation by subsystem. Each page below corresponds to a directory under kernel/ in the source tree and provides a brief overview of responsibilities and key components.

Kernel Subsystems

  • arch.ad — Architecture-specific boot, CPU, and memory implementations

  • cpu.ad — Process model and scheduling core

  • drivers.ad — Hardware device drivers (storage, keyboard, tty)

  • fs.ad — Filesystem stack (VFS, FAT, devfs, disk abstractions)

  • hal.ad — Hardware abstraction layer interface and bindings

  • init.ad — Kernel startup flow and handoff logic

  • mem.ad — Heap, PMM, VMM, process memory primitives

  • signal.ad — Signal delivery and signal syscall support

  • std.ad — Kernel-local libc-style utility implementations

  • sys.ad — System services, ELF loader, command line, dylib support

  • syscall.ad — Syscall dispatch and handlers

Navigation Notes

  • Start with init.ad for boot order and subsystem initialization sequence.

  • Read hal.ad and arch.ad together to understand portability boundaries.

  • Link this section with Userspace Documentation to follow kernel ↔ userspace interactions.

Revision History

v1.0

Initial kernel index and subsystem link map