# blanketsucks/kernel architecture

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

- Interactive diagram: https://gitdiagram.com/blanketsucks/kernel
- Repository: https://github.com/blanketsucks/kernel

## Overview

This repository is a C++ operating system: a booted kernel initializes hardware and core services, discovers storage, mounts an ext2 root filesystem, and starts user processes; userland includes a shell, utilities, and a dynamic loader. The graph preserves major kernel subsystems visible in the tree, while connections are limited to calls shown in excerpts. Several substantial implementations—including filesystem routing, process execution, and dynamic loading—were not sampled, so their uncertain runtime links are omitted.

Main entry points: [`kernel/main.cpp`](https://github.com/blanketsucks/kernel/blob/master/kernel/main.cpp) (Kernel startup), [`kernel/devices/storage/manager.cpp`](https://github.com/blanketsucks/kernel/blob/master/kernel/devices/storage/manager.cpp) (Storage discovery), [`kernel/memory/manager.cpp`](https://github.com/blanketsucks/kernel/blob/master/kernel/memory/manager.cpp) (Memory manager), [`userland/shell/main.cpp`](https://github.com/blanketsucks/kernel/blob/master/userland/shell/main.cpp) (Interactive shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_boot["Boot and memory"]
  node_kernel_entry["Kernel startup<br/>[main.cpp]"]
  node_memory["Memory manager<br/>[manager.cpp]"]
  node_physical_memory["Physical memory<br/>[pmm.cpp]"]
end

subgraph group_hardware["Hardware services"]
  node_time["Time services<br/>[manager.cpp]"]
  node_pci["PCI discovery<br/>[controller.cpp]"]
  node_gpu["Graphics devices<br/>[manager.cpp]"]
  node_input["Input devices<br/>[manager.cpp]"]
  node_audio["Audio devices<br/>[manager.cpp]"]
  node_network["Networking<br/>[manager.cpp]"]
  node_usb["USB controllers<br/>[controller.cpp]"]
end

subgraph group_storage["Storage and filesystems"]
  node_storage_manager["Storage discovery<br/>[manager.cpp]"]
  node_storage_drivers["Disk controllers<br/>[controller.cpp]"]
  node_devfs["Device filesystem<br/>[filesystem.cpp]"]
  node_ext2["Ext2 filesystem<br/>[inode.cpp]"]
  node_vfs["Virtual filesystem<br/>[vfs.cpp]"]
end

subgraph group_execution["Process execution"]
  node_process["Processes and threads<br/>[process.cpp]"]
  node_syscalls["System calls<br/>[syscalls.cpp]"]
  node_elf["ELF definitions<br/>[elf.h]"]
end

subgraph group_userland["Userland"]
  node_shell["Interactive shell<br/>[main.cpp]"]
  node_loader["Dynamic loader<br/>[main.cpp]"]
  node_libc_allocator["User allocator<br/>[liballoc.cpp]"]
end

node_machine(("Machine"))

node_machine -.->|"boots"| node_kernel_entry
node_kernel_entry -->|"initializes"| node_memory
node_memory -->|"creates"| node_physical_memory
node_kernel_entry -->|"initializes"| node_time
node_kernel_entry -->|"starts kernel process"| node_process
node_kernel_entry -->|"enumerates"| node_pci
node_kernel_entry -->|"creates controllers"| node_usb
node_kernel_entry -->|"initializes"| node_gpu
node_kernel_entry -->|"initializes"| node_input
node_kernel_entry -->|"initializes"| node_audio
node_kernel_entry -->|"initializes"| node_network
node_kernel_entry -->|"initializes"| node_storage_manager
node_storage_manager -->|"enumerates devices"| node_pci
node_storage_manager -->|"creates controllers"| node_storage_drivers
node_storage_manager -->|"registers devices"| node_devfs
node_kernel_entry -->|"creates root filesystem"| node_ext2
node_kernel_entry -->|"mounts root"| node_vfs
node_shell -->|"spawns commands"| node_process
node_machine -.->|"uses"| node_shell

click node_kernel_entry "https://github.com/blanketsucks/kernel/blob/master/kernel/main.cpp"
click node_memory "https://github.com/blanketsucks/kernel/blob/master/kernel/memory/manager.cpp"
click node_physical_memory "https://github.com/blanketsucks/kernel/blob/master/kernel/memory/pmm.cpp"
click node_time "https://github.com/blanketsucks/kernel/blob/master/kernel/time/manager.cpp"
click node_pci "https://github.com/blanketsucks/kernel/blob/master/kernel/pci/controllers/controller.cpp"
click node_gpu "https://github.com/blanketsucks/kernel/blob/master/kernel/devices/gpu/manager.cpp"
click node_input "https://github.com/blanketsucks/kernel/blob/master/kernel/devices/input/manager.cpp"
click node_audio "https://github.com/blanketsucks/kernel/blob/master/kernel/devices/audio/manager.cpp"
click node_network "https://github.com/blanketsucks/kernel/blob/master/kernel/net/manager.cpp"
click node_usb "https://github.com/blanketsucks/kernel/blob/master/kernel/usb/ohci/controller.cpp"
click node_storage_manager "https://github.com/blanketsucks/kernel/blob/master/kernel/devices/storage/manager.cpp"
click node_storage_drivers "https://github.com/blanketsucks/kernel/blob/master/kernel/devices/storage/ahci/controller.cpp"
click node_devfs "https://github.com/blanketsucks/kernel/blob/master/kernel/fs/devfs/filesystem.cpp"
click node_ext2 "https://github.com/blanketsucks/kernel/blob/master/kernel/fs/ext2fs/inode.cpp"
click node_vfs "https://github.com/blanketsucks/kernel/blob/master/kernel/fs/vfs.cpp"
click node_process "https://github.com/blanketsucks/kernel/blob/master/kernel/process/process.cpp"
click node_syscalls "https://github.com/blanketsucks/kernel/blob/master/kernel/process/syscalls.cpp"
click node_shell "https://github.com/blanketsucks/kernel/blob/master/userland/shell/main.cpp"
click node_loader "https://github.com/blanketsucks/kernel/blob/master/userland/loader/main.cpp"
click node_libc_allocator "https://github.com/blanketsucks/kernel/blob/master/libraries/libc/liballoc.cpp"
click node_elf "https://github.com/blanketsucks/kernel/blob/master/std/elf.h"

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_kernel_entry,node_memory,node_physical_memory toneBlue
class node_time,node_pci,node_gpu,node_input,node_audio,node_network,node_usb toneAmber
class node_storage_manager,node_storage_drivers,node_devfs,node_ext2,node_vfs toneMint
class node_process,node_syscalls,node_elf toneRose
class node_shell,node_loader,node_libc_allocator,node_machine toneIndigo
```

## Components

### Boot and memory

- [Kernel startup](https://github.com/blanketsucks/kernel/blob/master/kernel/main.cpp): `kernel/main.cpp`
- [Memory manager](https://github.com/blanketsucks/kernel/blob/master/kernel/memory/manager.cpp): `kernel/memory/manager.cpp`
- [Physical memory](https://github.com/blanketsucks/kernel/blob/master/kernel/memory/pmm.cpp): `kernel/memory/pmm.cpp`

### Hardware services

- [Time services](https://github.com/blanketsucks/kernel/blob/master/kernel/time/manager.cpp): `kernel/time/manager.cpp`
- [PCI discovery](https://github.com/blanketsucks/kernel/blob/master/kernel/pci/controllers/controller.cpp): `kernel/pci/controllers/controller.cpp`
- [Graphics devices](https://github.com/blanketsucks/kernel/blob/master/kernel/devices/gpu/manager.cpp): `kernel/devices/gpu/manager.cpp`
- [Input devices](https://github.com/blanketsucks/kernel/blob/master/kernel/devices/input/manager.cpp): `kernel/devices/input/manager.cpp`
- [Audio devices](https://github.com/blanketsucks/kernel/blob/master/kernel/devices/audio/manager.cpp): `kernel/devices/audio/manager.cpp`
- [Networking](https://github.com/blanketsucks/kernel/blob/master/kernel/net/manager.cpp): `kernel/net/manager.cpp`
- [USB controllers](https://github.com/blanketsucks/kernel/blob/master/kernel/usb/ohci/controller.cpp): `kernel/usb/ohci/controller.cpp`

### Storage and filesystems

- [Storage discovery](https://github.com/blanketsucks/kernel/blob/master/kernel/devices/storage/manager.cpp): `kernel/devices/storage/manager.cpp`
- [Disk controllers](https://github.com/blanketsucks/kernel/blob/master/kernel/devices/storage/ahci/controller.cpp): `kernel/devices/storage/ahci/controller.cpp`
- [Device filesystem](https://github.com/blanketsucks/kernel/blob/master/kernel/fs/devfs/filesystem.cpp): `kernel/fs/devfs/filesystem.cpp`
- [Ext2 filesystem](https://github.com/blanketsucks/kernel/blob/master/kernel/fs/ext2fs/inode.cpp): `kernel/fs/ext2fs/inode.cpp`
- [Virtual filesystem](https://github.com/blanketsucks/kernel/blob/master/kernel/fs/vfs.cpp): `kernel/fs/vfs.cpp`

### Process execution

- [Processes and threads](https://github.com/blanketsucks/kernel/blob/master/kernel/process/process.cpp): `kernel/process/process.cpp`
- [System calls](https://github.com/blanketsucks/kernel/blob/master/kernel/process/syscalls.cpp): `kernel/process/syscalls.cpp`
- [ELF definitions](https://github.com/blanketsucks/kernel/blob/master/std/elf.h): `std/elf.h`

### Userland

- [Interactive shell](https://github.com/blanketsucks/kernel/blob/master/userland/shell/main.cpp): `userland/shell/main.cpp`
- [Dynamic loader](https://github.com/blanketsucks/kernel/blob/master/userland/loader/main.cpp): `userland/loader/main.cpp`
- [User allocator](https://github.com/blanketsucks/kernel/blob/master/libraries/libc/liballoc.cpp): `libraries/libc/liballoc.cpp`

### Other components

- **Machine**

## Connections

- Machine → Kernel startup: boots
- Kernel startup → Memory manager: initializes (evidence: `kernel/main.cpp`)
- Memory manager → Physical memory: creates (evidence: `kernel/memory/manager.cpp`)
- Kernel startup → Time services: initializes (evidence: `kernel/main.cpp`)
- Kernel startup → Processes and threads: starts kernel process (evidence: `kernel/main.cpp`)
- Kernel startup → PCI discovery: enumerates (evidence: `kernel/main.cpp`)
- Kernel startup → USB controllers: creates controllers (evidence: `kernel/main.cpp`)
- Kernel startup → Graphics devices: initializes (evidence: `kernel/main.cpp`)
- Kernel startup → Input devices: initializes (evidence: `kernel/main.cpp`)
- Kernel startup → Audio devices: initializes (evidence: `kernel/main.cpp`)
- Kernel startup → Networking: initializes (evidence: `kernel/main.cpp`)
- Kernel startup → Storage discovery: initializes (evidence: `kernel/main.cpp`)
- Storage discovery → PCI discovery: enumerates devices (evidence: `kernel/devices/storage/manager.cpp`)
- Storage discovery → Disk controllers: creates controllers (evidence: `kernel/devices/storage/manager.cpp`)
- Storage discovery → Device filesystem: registers devices (evidence: `kernel/devices/storage/manager.cpp`)
- Kernel startup → Ext2 filesystem: creates root filesystem (evidence: `kernel/main.cpp`)
- Kernel startup → Virtual filesystem: mounts root (evidence: `kernel/main.cpp`)
- Interactive shell → Processes and threads: spawns commands (evidence: `userland/shell/main.cpp`)
- Machine → Interactive shell: uses
