Skip to content

Coding an operating system to keep my sanity during the quarantine.

License

Notifications You must be signed in to change notification settings

CyanOS-Project/CyanOSKernel

Repository files navigation

CyanOS Build Status Codacy Badge

What's is this ?

It's a x86 monolithic preemptive kernel, coded in C++20 and few lines of x86 Assembly.

Why ?

Why a new half working operating systems? you might ask, And the answer: because it's fun. This is my biggest project so far and I'm really learning a lot of new stuff on the way and enjoying every line I write (until I face a race condition bug, I would hate my life by then). I'm trying my best to work out a clean architecture for this project and maintaining a readable & scalable code base as far as i can (it might far from perfect right now).

What can it do ?

  • Virtual Memory.
  • Heap Allocator.
  • Concurrency in terms of Threads & Processes.
  • Basic ELF loader
  • Task Synchronization (WaitQueues, Spinlocks, Semaphores and Mutex)
  • Inter-process communication (using pipes & sockets)
  • Virtual File System.
  • User Space.
  • A Shell & basic commands like cd, ls, cat...
  • PCI bus.
  • RTL8139 Ethernet Driver.
  • Networking (IPv4, UDP, TCP, ARP and DHCP)

Building CyanOS

Requirements

sudo apt-get update
sudo apt-get install gcc-multilib g++-multilib build-essential nasm python3 cmake grub2 xorriso mtools qemu 

For Windows users, you can build and run the system on WSL1/WSL2 (Windows Subsystem for Linux).

Building Cross compiler GCC/GDB

sudo chmod -x build_cross_compiling_tools.sh
sudo ./build_cross_compiling_tools.sh

Building

First, you need to build cross compiler gcc, check out how in this osdev wiki page.
Then, Follow these commands:

git clone --recursive https://github.com/AymenSekhri/CyanOS.git
cd ./CyanOS
mkdir build && cd build
cmake .. -G "Unix Makefiles"
make

And you can boot up the OS in Qemu using:

make run

You have a question or suggestion ?

Add an issue, and I will be happy to answer you.

Acknowledgement

I would like to thank Andreas Kling, I learned so much from his youtube channel and his great open source project SerenityOS.

Useful resources

About

Coding an operating system to keep my sanity during the quarantine.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •