Skip to content

getting-started.md

Latest commit

 

History

History
72 lines (53 loc) · 1.57 KB

getting-started.md

File metadata and controls

72 lines (53 loc) · 1.57 KB
Raw

Getting Started

Prerequisites

  • GCC with 32-bit support (gcc -m32)
  • GNU linker (ld)
  • QEMU (qemu-system-i386)
  • make

On Debian/Ubuntu:

sudo apt-get install gcc gcc-multilib make qemu-system-x86

Building

make            # release build
make debug      # debug build with symbols
make test       # run host-side unit tests
make clean      # remove build artifacts

The build produces build/kernel.bin, a 32-bit Multiboot ELF kernel.

Running in QEMU

make run        # serial output on terminal (headless)
make run-vga    # opens QEMU window with VGA display
make run-debug  # paused for GDB on port 1234

Or manually:

qemu-system-i386 -kernel build/kernel.bin -serial stdio -display none -no-reboot -m 128M

Expected Output

On boot, serial output shows kernel initialization:

BOOT
KERNEL: CLLM unikernel booting
KERNEL: Memory initialized
KERNEL: Network initialized
KERNEL: Self-tests passed
KERNEL: Entering network loop

Key Components

Component Source Description
Bootloader src/boot.S Multiboot-compliant entry point
Kernel src/kernel.c VGA, serial, initialization
String/Memory src/string.c, src/memory.c libc subset
HTTP Server src/http.c, src/api.c REST API framework
Network src/network.c, src/network/ PCI + e1000 NIC driver
LLM Interface src/llm.c, src/c_model_interface.c Model loading

Debugging

Attach GDB to a running debug kernel:

make run-debug &
gdb build/kernel.bin -ex "target remote :1234"