# krisbutiamanosdev/nyonos architecture

> Architecture diagram of the GitHub repository krisbutiamanosdev/nyonos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/krisbutiamanosdev/nyonos
- Repository: https://github.com/krisbutiamanosdev/nyonos

## Overview

nyonOS is a minimal x86_64 kernel booted through Limine. Its principal workflow is firmware/bootloader handoff into kernel initialization, followed by memory and interrupt setup and runtime services for multitasking, syscalls, storage, input, and display. The graph preserves the README’s documented capabilities and the substantial runtime modules in the source index. Several initialization and service links are dashed because the available excerpts do not show the relevant call sites.

Main entry points: [`src/kernel.c`](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel.c) (Kernel entry), [`src/kernel/multitask/task.c`](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/multitask/task.c) (Tasks and scheduling), [`src/arch/x86_64/syscall/syscall.c`](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/syscall/syscall.c) (Syscall handling), [`src/kernel/mm/vmm/vmm.c`](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/mm/vmm/vmm.c) (Virtual memory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_boot["Boot and entry"]
  node_limine["Limine protocol<br/>[limine.h]"]
  node_kernel["Kernel entry<br/>[kernel.c]"]
end

subgraph group_arch["x86 architecture"]
  node_gdt["GDT and TSS<br/>[gdt.c]"]
  node_idt["IDT and IRQ dispatch<br/>[idt.c]"]
  node_pic["PIC controller<br/>[pic.c]"]
  node_pit["PIT timer<br/>[pit.c]"]
  node_lapic["Local APIC<br/>[lapic.c]"]
  node_syscall["Syscall handling<br/>[syscall.c]"]
  node_syscall_msr["Syscall MSRs<br/>[syscall_msr.c]"]
end

subgraph group_memory["Memory management"]
  node_pmm["Physical memory<br/>[pmm.c]"]
  node_vmm["Virtual memory<br/>[vmm.c]"]
  node_heap["Kernel heap<br/>[heap.c]"]
end

subgraph group_runtime["Kernel runtime"]
  node_task["Tasks and scheduling<br/>[task.c]"]
  node_sync["Locks and preemption<br/>[sync.c]"]
  node_preempt["Preemption state<br/>[preempt.c]"]
  node_fd["File descriptors<br/>[fd.c]"]
  node_fs["FAT16 filesystem<br/>[fs.c]"]
  node_block["Block layer<br/>[block.c]"]
  node_panic["Panic handling<br/>[panic.c]"]
end

subgraph group_devices["Devices and display"]
  node_ata["ATA driver<br/>[ata.c]"]
  node_keyboard["PS/2 keyboard<br/>[keyboard.c]"]
  node_serial["Serial output<br/>[serial.c]"]
  node_video["Framebuffer video<br/>[video.c]"]
  node_font["Font data<br/>[font_data.h]"]
  node_kprintf["Kernel printing<br/>[kprintf.c]"]
end

node_firmware(("BIOS / UEFI"))

node_firmware -->|"boots through"| node_limine
node_limine -.->|"hands off"| node_kernel
node_kernel -.->|"initializes"| node_gdt
node_kernel -.->|"initializes"| node_idt
node_kernel -.->|"initializes"| node_pmm
node_kernel -.->|"initializes"| node_vmm
node_kernel -.->|"initializes"| node_task
node_kernel -.->|"configures"| node_pit
node_kernel -.->|"initializes"| node_syscall
node_pmm -->|"provides pages"| node_vmm
node_vmm -->|"maps memory"| node_heap
node_pit -->|"installs handler"| node_idt
node_pit -.->|"ticks scheduling"| node_task
node_idt -->|"acknowledges IRQs"| node_pic
node_task -->|"manages address spaces"| node_vmm
node_task -->|"uses TSS"| node_gdt
node_task -->|"sets up user tasks"| node_syscall
node_syscall -->|"uses descriptors"| node_fd
node_syscall -->|"uses filesystem"| node_fs
node_fs -->|"reads blocks"| node_block
node_block -->|"delegates I/O"| node_ata
node_fd -.->|"uses input"| node_keyboard
node_kernel -.->|"initializes"| node_keyboard
node_kernel -.->|"may initialize"| node_lapic
node_kernel -.->|"configures"| node_syscall_msr
node_kprintf -->|"writes output"| node_serial
node_kprintf -->|"renders output"| node_video
node_video -.->|"uses glyphs"| node_font
node_panic -->|"logs failure"| node_serial
node_panic -->|"prints diagnostics"| node_kprintf
node_sync -.->|"controls preemption"| node_preempt

click node_limine "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/boot/limine/limine.h"
click node_kernel "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel.c"
click node_gdt "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/gdt/gdt.c"
click node_idt "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/idt/idt.c"
click node_pic "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/pic/pic.c"
click node_pit "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/pit/pit.c"
click node_lapic "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/lapic/lapic.c"
click node_syscall "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/syscall/syscall.c"
click node_syscall_msr "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/syscall/syscall_msr.c"
click node_pmm "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/mm/pmm/pmm.c"
click node_vmm "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/mm/vmm/vmm.c"
click node_heap "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/mm/heap/heap.c"
click node_task "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/multitask/task.c"
click node_sync "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/sync/sync.c"
click node_preempt "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/sync/preempt.c"
click node_fd "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/fd/fd.c"
click node_fs "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/fs/fs.c"
click node_block "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/block/block.c"
click node_panic "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/panic/panic.c"
click node_ata "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/drivers/ata/ata.c"
click node_keyboard "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/drivers/keyboard/keyboard.c"
click node_serial "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/drivers/serial/serial.c"
click node_video "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/graphics/video/video.c"
click node_font "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/graphics/font/font_data.h"
click node_kprintf "https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/kprintf/kprintf.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_limine,node_kernel toneBlue
class node_gdt,node_idt,node_pic,node_pit,node_lapic,node_syscall,node_syscall_msr toneAmber
class node_pmm,node_vmm,node_heap toneMint
class node_task,node_sync,node_preempt,node_fd,node_fs,node_block,node_panic toneRose
class node_ata,node_keyboard,node_serial,node_video,node_font,node_kprintf,node_firmware toneIndigo
```

## Components

### Boot and entry

- [Limine protocol](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/boot/limine/limine.h): `src/boot/limine/limine.h`
- [Kernel entry](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel.c): `src/kernel.c`

### x86 architecture

- [GDT and TSS](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/gdt/gdt.c): `src/arch/x86_64/gdt/gdt.c`
- [IDT and IRQ dispatch](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/idt/idt.c): `src/arch/x86_64/idt/idt.c`
- [PIC controller](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/pic/pic.c): `src/arch/x86_64/pic/pic.c`
- [PIT timer](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/pit/pit.c): `src/arch/x86_64/pit/pit.c`
- [Local APIC](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/lapic/lapic.c): `src/arch/x86_64/lapic/lapic.c`
- [Syscall handling](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/syscall/syscall.c): `src/arch/x86_64/syscall/syscall.c`
- [Syscall MSRs](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/arch/x86_64/syscall/syscall_msr.c): `src/arch/x86_64/syscall/syscall_msr.c`

### Memory management

- [Physical memory](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/mm/pmm/pmm.c): `src/kernel/mm/pmm/pmm.c`
- [Virtual memory](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/mm/vmm/vmm.c): `src/kernel/mm/vmm/vmm.c`
- [Kernel heap](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/mm/heap/heap.c): `src/kernel/mm/heap/heap.c`

### Kernel runtime

- [Tasks and scheduling](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/multitask/task.c): `src/kernel/multitask/task.c`
- [Locks and preemption](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/sync/sync.c): `src/kernel/sync/sync.c`
- [Preemption state](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/sync/preempt.c): `src/kernel/sync/preempt.c`
- [File descriptors](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/fd/fd.c): `src/kernel/fd/fd.c`
- [FAT16 filesystem](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/fs/fs.c): `src/kernel/fs/fs.c`
- [Block layer](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/block/block.c): `src/kernel/block/block.c`
- [Panic handling](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/panic/panic.c): `src/kernel/panic/panic.c`

### Devices and display

- [ATA driver](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/drivers/ata/ata.c): `src/drivers/ata/ata.c`
- [PS/2 keyboard](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/drivers/keyboard/keyboard.c): `src/drivers/keyboard/keyboard.c`
- [Serial output](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/drivers/serial/serial.c): `src/drivers/serial/serial.c`
- [Framebuffer video](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/graphics/video/video.c): `src/graphics/video/video.c`
- [Font data](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/graphics/font/font_data.h): `src/graphics/font/font_data.h`
- [Kernel printing](https://github.com/krisbutiamanosdev/nyonos/blob/main/src/kernel/kprintf/kprintf.c): `src/kernel/kprintf/kprintf.c`

### Other components

- **BIOS / UEFI**

## Connections

- BIOS / UEFI → Limine protocol: boots through
- Limine protocol → Kernel entry: hands off (evidence: `src/kernel.c`)
- Kernel entry → GDT and TSS: initializes
- Kernel entry → IDT and IRQ dispatch: initializes
- Kernel entry → Physical memory: initializes
- Kernel entry → Virtual memory: initializes
- Kernel entry → Tasks and scheduling: initializes
- Kernel entry → PIT timer: configures
- Kernel entry → Syscall handling: initializes
- Physical memory → Virtual memory: provides pages (evidence: `src/kernel/mm/vmm/vmm.c`)
- Virtual memory → Kernel heap: maps memory (evidence: `src/kernel/mm/heap/heap.c`)
- PIT timer → IDT and IRQ dispatch: installs handler (evidence: `src/arch/x86_64/pit/pit.c`)
- PIT timer → Tasks and scheduling: ticks scheduling
- IDT and IRQ dispatch → PIC controller: acknowledges IRQs (evidence: `src/arch/x86_64/idt/idt.c`)
- Tasks and scheduling → Virtual memory: manages address spaces (evidence: `src/kernel/multitask/task.c`)
- Tasks and scheduling → GDT and TSS: uses TSS (evidence: `src/kernel/multitask/task.c`)
- Tasks and scheduling → Syscall handling: sets up user tasks (evidence: `src/kernel/multitask/task.c`)
- Syscall handling → File descriptors: uses descriptors (evidence: `src/arch/x86_64/syscall/syscall.c`)
- Syscall handling → FAT16 filesystem: uses filesystem (evidence: `src/arch/x86_64/syscall/syscall.c`)
- FAT16 filesystem → Block layer: reads blocks (evidence: `src/kernel/fs/fs.c`)
- Block layer → ATA driver: delegates I/O (evidence: `src/kernel/block/block.c`)
- File descriptors → PS/2 keyboard: uses input
- Kernel entry → PS/2 keyboard: initializes
- Kernel entry → Local APIC: may initialize
- Kernel entry → Syscall MSRs: configures
- Kernel printing → Serial output: writes output (evidence: `src/kernel/kprintf/kprintf.c`)
- Kernel printing → Framebuffer video: renders output (evidence: `src/kernel/kprintf/kprintf.c`)
- Framebuffer video → Font data: uses glyphs
- Panic handling → Serial output: logs failure (evidence: `src/kernel/panic/panic.c`)
- Panic handling → Kernel printing: prints diagnostics (evidence: `src/kernel/panic/panic.c`)
- Locks and preemption → Preemption state: controls preemption
