Skip to content

Patchwork is a hobbyist OS built from scratch in C for the x86_64 architecture with a monolithic kernel.

License

Notifications You must be signed in to change notification settings

KaiNorberg/PatchworkOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Patchwork OS License

Keep in mind that PatchworkOS is currently in a very early stage of development.

Features

  • Very simple Unix inspired architecture (Not Unix-like)
  • Monolithic preemptive 64-bit kernel
  • SMP (Symmetric Multiprocessing)
  • Multithreading (Kernel Level Threads)
  • O(1) scheduler
  • Custom Standard Library
  • Custom UEFI Bootloader
  • More to be added...

Limitations

  • Ram disks only
  • Only x86_64

Tested Hardware Configurations

  • Lenovo Thinkpad E495
  • Ryzen 5 3600X | 32GB 3200MHZ Corsair Vengeance

Currently untested on Intel hardware.

Setup

1. Cloning (downloading) this repository

To clone (download) this repository, you can use the Code button at the top left of the screen, or if you have git installed use the following command git clone --recursive https://github.com/KaiNorberg/PatchworkOS.

2. Building Patchwork

In order to build Patchwork you will need to use Linux. You will also need to have Make, NASM and GCC installed, it is also possible to use clang by just editing the Makefile.

After everything is installed simply run make setup all. You should then find a .img file in the bin directory.

3. Running Patchwork

There are three ways to run Patchwork.

  1. Use a tool like balenaEtcher to create a bootable USB using the created .img file.
  2. Download QEMU on your Linux machine and use make run.
  3. Run the created .img file in a virtual machine of your choice.

Roadmap

The short term goal is to create a basic user-space shell, however the long term goal is to play DOOM.

Documentation (WIP)

Documentation will eventually be found on the wiki page.

Contributing

Patchwork is intended as a personal project, therefor contributions are unwanted. However if you find any bugs, issues or just have a suggestion for something i could do better, then feel free to open an issue. This might change in the future.

About

Patchwork is a hobbyist OS built from scratch in C for the x86_64 architecture with a monolithic kernel.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published