Kernel subsystems
Per-driver and per-module reference documentation for Makar’s kernel. These pages are organized around source ownership: each page explains the public interfaces, invariants, and current behavior of one subsystem rather than retelling the whole OS architecture.
For cross-subsystem topics, use:
| Topic | Reference |
|---|---|
| Process lifecycle, scheduler, signals, fork/exec/wait | Internals |
| Syscall numbers and ABI registers | Syscalls |
| POSIX compatibility state | POSIX |
| In-guest test matrix | Testing |
| Document | Description |
|---|---|
| kernel | Boot entry point and post-boot heartbeat |
| system | Panic, halt, and assertion helpers |
| asm | Inline x86 port I/O and CPU-control helpers |
| types | Common type aliases and geometric structs |
| fpu | x87/SSE FPU bring-up + per-task FXSAVE state |
| vm | Hypervisor / virtual-machine detection |
| acpi | RSDP/FADT discovery, shutdown & reboot |
| vga | VGA text-mode constants and low-level helpers |
| tty | VGA text terminal driver |
| serial | Serial port (UART) driver |
| descr_tbl | GDT, IDT, TSS, and TLS descriptor setup |
| isr | Interrupt, exception, IRQ, and syscall dispatch |
| timer | PIT timer driver |
| pmm | Physical memory manager |
| paging | Paging, COW faults, and user virtual memory |
| heap | Kernel heap allocator |
| vesa | VESA linear framebuffer |
| bochs_vbe | Bochs VBE / QEMU BGA (DISPI) mode-setting |
| video | Display-driver framework (vtable + SVGA II) |
| vesa_tty | VESA bitmap-font text renderer |
| vt | Per-TTY logical character grid |
| vtty | Virtual TTY manager (Alt+Fn, focus, status bar) |
| debug | Debug-exception handlers + the fail-safe panic |
| multiboot | Multiboot 2 structures |
| keyboard | Layered PS/2 keyboard driver |
| mouse | PS/2 mouse driver + event queue |
| pci | PCI bus scan + driver binding |
| ide | ATA/IDE PIO driver |
| partition | MBR + GPT partition tables |
| ext2 | ext2 filesystem driver (read + write + mkfs) |
| procfs | Synthetic /proc filesystem |
| devfs | Synthetic /dev block devices (disks, partitions, CD-ROM) |
| shell | Kernel command shell, builtins, and script dispatcher |
Networking (the lwIP stack + the four NICs) is covered in networking; the syscall surface in syscalls.