AuriOS Docs

Building & running

Everything goes through the Makefile at the repository root. Run make help to list the available targets.

Build the kernel

make all

This target:

  1. compiles all C files (src/kernel, src/cpu, src/lib, src/drivers);
  2. assembles the .s and .asm files with nasm;
  3. links everything into a kernel binary output/AuriOS.bin via linker.ld.

Generate the ISO image

make iso

The binary is packaged with GRUB (Multiboot) into a bootable output/AuriOS.iso image.

Run in QEMU

make run

Test mode (serial output)

To build with test mode enabled (AURI_TEST_MODE, redirects logs to the serial port):

make iso-debug

Clean

make clean

Removes all build artifacts (build/, output/).

Boot sequence

On startup, the kernel (kernel_main) initializes, in order: serial port, GDT, PIC remapping, IDT, terminal, timer (1000 Hz), then enables interrupts. It then sets up memory (PMM, then MMU paging), plays the logo animation, initializes the keyboard and starts the interactive shell.