CeDOS - Summary

Update Readme Signed-off-by: Celina Sophie Kalus <hello@celinakalus.de>
Celina Sophie Kalus
hello@celinakalus.de
Fri, 25 Jul 2025 22:58:14 +0200
run.sh: Automatically create logs folder Signed-off-by: Celina Sophie Kalus <hello@celinakalus.de>
Celina Sophie Kalus
hello@celinakalus.de
Fri, 25 Jul 2025 22:45:39 +0200
shell.nix: Fix missing build dependencies Signed-off-by: Celina Sophie Kalus <hello@celinakalus.de>
Celina Sophie Kalus
hello@celinakalus.de
Fri, 25 Jul 2025 22:06:03 +0200

CeDOS

Simple x86 operating system written in assembly and C.

Software Requirements

  • CMake + Ninja
  • GCC Cross Compiler + matching binutils, tailored for freestanding i686-elf-targets
  • Doxygen: If you want to build the documentation
  • QEMU: To emulate an x86 system. More specifically, qemu-system-i386, available via apt.

Easiest way to get these is to use the nix development shell:

nix develop

Make commands

Build

mkdir -p build/
cd build/
cmake -GNinja ..
ninja

The image is put into build/images/cedos.img and can be flashed onto a bootable storage device or run in QEMU.

Run (in QEMU)

./run.sh build/images/cedos.img

Clear output directories

cd build/
ninja clean

Run tests

cd build/
../test.sh
clone 
git clone https://git.celinakalus.de/CeDOS