How project-nirmala/source works
This repository is a small x86-64 operating-system project with a Unix-like userland, kernel, and native C build tools. The boot workflow shown is Limine handoff into kernel initialization, memory and device setup, initrd filesystem mounting, and launch of /sbin/init. The tree also contains login/shell utilities, libc, a compiler, linker, make utility, and configuration tool. Edges are limited to calls visible in excerpts; unsampled subsystem wiring and userland startup relationships are not inferred.
Main entry points: kern/main.c Kernel startup · vfs.c Virtual filesystem · src/main.c C compiler · src/main.c ELF linker
Components 22
Kernel Boot
- Kernel startup
sys/kern/main.c - Processes & exec
sys/kern/proc.c - System calls
sys/kern/syscall.c
Architecture & Devices
- CPU setup
sys/arch/amd64/cpu.c - Interrupt table
sys/arch/amd64/idt.c - PIC controller
sys/arch/amd64/pic.c - Serial console
sys/dev/serial.c - Framebuffer console
sys/dev/fbcon.c
Memory & Filesystems
- Physical memory
sys/vm/pmm.c - Virtual memory
sys/vm/vmm.c - Kernel heap
sys/vm/kheap.c - Virtual filesystem
sys/fs/vfs.c - Lemon filesystem
sys/fs/lemonfs.c
Userland & libc
- Init process
sbin/init/init.c - C library
lib/libc/stdio.c - Login
bin/login/login.c - Shell
bin/sh/sh.c
Build Tools
- C compiler
bin/nircc/src/main.c - ELF linker
bin/nirld/src/main.c - Build executor
bin/nirmake/src/main.c - Config parser
tools/nirconfig/nc_parse.c
Other components
- Limine bootloader
Connections 15
- Limine bootloader → Kernel startup: boots
sys/kern/main.c - Kernel startup → Serial console: initializes
sys/kern/main.c - Kernel startup → Interrupt table: initializes
sys/kern/main.c - Kernel startup → CPU setup: initializes
sys/kern/main.c - Kernel startup → Physical memory: initializes
sys/kern/main.c - Kernel startup → Virtual memory: initializes
sys/kern/main.c - Kernel startup → Kernel heap: initializes
sys/kern/main.c - Kernel startup → Framebuffer console: initializes
sys/kern/main.c - Kernel startup → PIC controller: initializes
sys/kern/main.c - Kernel startup → Virtual filesystem: mounts initrd
sys/kern/main.c - Kernel startup → Processes & exec: starts init
sys/kern/main.c - Virtual filesystem → Lemon filesystem
- Kernel startup → Init process: launches
sys/kern/main.c - C compiler → C compiler: preprocesses, parses, emits
bin/nircc/src/main.c - ELF linker → ELF linker: links inputs
bin/nirld/src/main.c