eduOS-rs - A teaching operating system written in Rust
eduOS-rs is a Unix-like operating system based on a monolithic architecture for educational purposes. It is developed for the course Operating Systems at RWTH Aachen University and includes a modified hypervisor that simplifies the boot process to increase the intelligibility of the OS. eduOS-rs is derived from following tutorials and software distributions:
- Philipp Oppermann's excellent series of blog posts.
- Erik Kidd's toyos-rs, which is an extension of Philipp Opermann's kernel.
- The original version of eduOS, which was the old teaching kernel written in C.
Requirements to build eduOS-rs
eduOS-rs is tested under Linux, macOS, and Windows.
Apple's Command Line Tools must be installed. The Command Line Tool package gives macOS terminal users many commonly used tools and compilers, that are usually found in default Linux installations. Following terminal command installs these tools without Apple's IDE Xcode:
$ xcode-select --install
Linux users should install common developer tools. For instance, on Ubuntu 18.04 the following command installs the required tools:
$ apt-get install -y git curl wget nasm make autotools-dev gcc g++ build-essential lld-8
Common for macOS, Windows and Linux
It is required to install the Rust toolchain. Please visit the Rust website and follow the installation instructions for your operating system. It is important that the nightly channel is used to install the toolchain. This is queried during installation and should be answered as appropriate.
Afterwards the installation the source code of Rust runtime and the llvm tools are required to build the kernel:
$ rustup component add rust-src $ rustup component add llvm-tools-preview
$ cargo install --git https://github.com/RWTH-OS/ehyve.git
Please check if your system fullfil ehyve's system requirements.
To build the kernel, it is important to add the path to llvm-tools to the environment variable
Depening on the operating systems, the tools are located at:
The final step is to create a copy of the repository and to build the kernel:
$ # Get our source code. $ git clone https://github.com/RWTH-OS/eduOS-rs.git $ cd eduOS-rs $ # Build kernel $ cargo build
From here, we should be able to run the kernel in ehyve:
$ cargo run
Overview of all branches
Step by step (here branch by branch) the operating system design will be introduced. This tutorial shows the steps to develop from a minimal kernel to a Unix-like computer operating system. Currently, following stages of development are available:
stage0 - Smallest HelloWorld of the World
Description of loading a minimal 64bit kernel
stage1 - Cooperative/non-preemptive multitasking
Introduction into a simple form of multitasking, where no interrupts are required.
stage2 - Priority-based cooperative/non-preemptive multitasking
Introduction into a simple form of priority-based multitasking, where no interrupts are required.
stage3 - Synchronization primitives
Introduce basic synchronization primitives
stage 4 - Preemptive multitasking
Introduction into preemptive multitasking and interrupt handling
stage 5 - Support of user-level tasks
Add support of user-level tasks with an small interface for basic system calls
stage 6 - Support of paging
Add support of paging and a simple demo for process creation
stage 7 - Integration of an in-memory file system
Introduce a virtual file system with an in-memory file system as example file system.
stage8 - Run Linux application as common process
Start a simple Linux application (HelloWorld) on top of eduOS-rs. The application is a position-independent executable (PIE) and use musl-libc as standard C library.
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.