How bravinevans/kernec works
Kernec is an early-stage x86_64 operating-system kernel. Its current boot workflow initializes serial output, CPU descriptor and interrupt state, the legacy PIC, and a periodic timer before entering an idle loop. The kernel also has a small system-call path: dispatch by number through a table to the null handler. The tree names broader OS areas, but their directories contain no implementation files here. Relationships are limited to shown calls and indexed references; the README supplied no content, and unsampled assembly wiring is not inferred.
Main entry points: main.c Kernel entry · interrupts.c Interrupt handling · serial.c Serial console · pic.c 8259 PIC
Components 13
Kernel startup
- Kernel entry
kernel/main.c
x86_64 platform
- Serial console
kernel/arch/x86_64/serial.c - GDT setup
kernel/arch/x86_64/gdt.c - Interrupt handling
kernel/arch/x86_64/interrupts.c - 8259 PIC
kernel/arch/x86_64/pic.c - PIT timer
kernel/arch/x86_64/timer.c - CPU control
kernel/arch/x86_64/cpu.c
System calls
- Syscall entry
kernel/syscall/arch/x86_64/entry.S - Syscall dispatcher
kernel/syscall/dispatcher.c - Syscall table
kernel/syscall/table.c - Null handler
kernel/syscall/handlers/null.c
Kernel core
- Kernel panic
kernel/core/panic.c
Other components
- Limine bootloader
Connections 16
- Limine bootloader → Kernel entry: enters
- Kernel entry → Serial console: initializes and writes
kernel/main.c - Kernel entry → GDT setup: initializes
kernel/main.c - Kernel entry → Interrupt handling: initializes
kernel/main.c - Kernel entry → 8259 PIC: initializes
kernel/main.c - Kernel entry → 8259 PIC: unmasks IRQ
kernel/main.c - Kernel entry → PIT timer: initializes
kernel/main.c - Kernel entry → CPU control: idles or halts
kernel/main.c - Interrupt handling → 8259 PIC: sends EOI
kernel/arch/x86_64/interrupts.c - Interrupt handling → Serial console: reports fatal events
kernel/arch/x86_64/interrupts.c - Interrupt handling → CPU control: halts on fatal event
kernel/arch/x86_64/interrupts.c - Kernel panic → Serial console: writes panic
kernel/core/panic.c - Kernel panic → CPU control: halts
kernel/core/panic.c - Syscall entry → Syscall dispatcher: dispatches to
- Syscall dispatcher → Syscall table: indexes handler
kernel/syscall/dispatcher.c - Syscall table → Null handler: registers
kernel/syscall/table.c