How kris-dreemurr-dev/overos works
overOS is a bare-metal x86_64 operating system. Its documented startup proceeds from BIOS and the boot loader into kernel initialization, then starts terminal and user processes; users launch programs through the shell, while the desktop runs as a Ring 3 program. The map also preserves major documented capabilities: process isolation and scheduling, user permissions, USB storage and FAT32, desktop composition, built-in IDE/compiler, and game ports. Some subsystem links rely on README descriptions because their implementation files were not excerpted.
Main entry points: main.c Kernel initialization · user_mode.c System call boundary · tty.h TTY and login · desktop.c Desktop compositor
Components 23
Boot and kernel
- Boot and VBE menu
src/boot/vbe_menu.c - Kernel initialization
src/kernel/main.c - Physical and virtual memory
src/memory/vmm.c
Processes and users
- System call boundary
src/kernel/user_mode.c - Process scheduler
src/kernel/sched.c - Users and permissions
src/kernel/users.h - TTY and login
src/kernel/tty.h - Ring 3 shell
src/programs/sh.c
Devices and storage
- VFS and FAT32
src/fs/fat32.c - Block device registry
src/drivers/blk.h - USB controllers
src/drivers/usb/xhci.c - HDA audio
src/drivers/hda.c - Ethernet
src/drivers/ethernet.c
Desktop and apps
- Desktop compositor
src/files/progs/Desktop/desktop.c - Window server
src/files/progs/Desktop/wserver.c - UI library
src/libs/libui/ui.c - IDE and C compiler
src/modules/redactor/compiler.c
Game ports
- DOOM port
src/files/progs/DOOM/doomgeneric/d_main.c - Quake port
src/files/progs/Quake/quakegeneric/host.c - overCraft game
src/files/progs/overCraft/main.cpp - 3D rendering engine
src/files/progs/overCraft/engine/ovengine.h
Other components
- BIOS firmware
- Computer user
Connections 26
- BIOS firmware → Boot and VBE menu: starts boot
- Boot and VBE menu → Kernel initialization: loads kernel
- Kernel initialization → Physical and virtual memory: initializes memory
- Kernel initialization → TTY and login: starts terminal
src/kernel/main.c - Kernel initialization → Process scheduler: initializes scheduler
- Kernel initialization → USB controllers: initializes USB
src/kernel/main.c - Kernel initialization → VFS and FAT32: initializes storage
src/kernel/main.c - TTY and login → Users and permissions: loads accounts
- TTY and login → Ring 3 shell: starts shell
- Computer user → Ring 3 shell: enters commands
- Ring 3 shell → System call boundary: invokes services
src/programs/sh.c - System call boundary → Process scheduler: controls processes
src/kernel/user_mode.c - System call boundary → Physical and virtual memory: manages address spaces
src/kernel/user_mode.c - System call boundary → VFS and FAT32: performs file I/O
src/kernel/user_mode.c - USB controllers → Block device registry: registers disks
src/drivers/blk.h - Block device registry → VFS and FAT32: serves sectors
src/drivers/blk.h - Computer user → Desktop compositor: opens desktop
- Desktop compositor → Window server: composes windows
- Desktop compositor → UI library: uses widgets
- Computer user → IDE and C compiler: edits and builds
- Computer user → DOOM port: plays
- Computer user → Quake port: plays
- Computer user → overCraft game: plays
- overCraft game → 3D rendering engine: renders with
src/files/progs/overCraft/main.cpp - Kernel initialization → HDA audio: initializes audio
src/kernel/main.c - Kernel initialization → Ethernet: initializes network
src/kernel/main.c