/endros

Minimal OS with Linux API/ABI compatibility for RISC-V

Primary LanguageCGNU General Public License v3.0GPL-3.0

EndrOS

Warning

This OS is unfinished. It is a demonstration of OS for me to learn and is recommended for OS course projects, learning OS and RISC-V, etc. You are not encouraged to use this in production.



EndrOS - Minimal OS with Linux API/ABI compatibility for RISC-V

This project is a demonstration of the basic components of an OS kernel. The project is inspired by rCoreOS, but it is built completely without third-party libraries and only C.

You are free to use, learn, and redistribute under GNU GPL v3 license.

Features

The system features, ordered in Three Easy Pieces:

  • Virtualization:
    • Page Table
    • Recursive Page Table for kernel space mapping
    • Isolated Processes
    • Round-Robin Scheduler
    • Users / Groups
    • Dynamic Linker
    • MLFQ
  • Concurrency (Not implemented yet)
    • Multi-core support
    • Threads
    • Locks
    • Asynchronous I/O
  • Persistence
    • Read-only Filesystem (VSFS)
    • VirtIO Block Device Driver
    • Buffered Block
    • Files
    • Everything is a File
    • VirtIO Graphics Driver
    • DTB Parsing (now only has a function to print)

For user programs, it has:

  • init
  • sh
  • ls

Build

Make sure you have riscv-gnu-toolchain installed.

$ git clone https://github.com/endaytrer/endros.git
$ cd endros
$ make defconfig
$ make

The OS Kernel (ELF) is endros, and the raw binary is endros.img.

The process also builds a disk image for user programs: fs.img. It is done by script/mkfs.py, which you can use to create any VSFS image from any directory by using:

$ script/mkfs.py -o fs.img DIRECTORY

Run

Currently, EndrOS only supports to be run in QEMU. Make sure you have qemu-system-riscv64.

$ make qemu