Skip to content

RWTH-OS/eduOS-rs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

0ba1810 · Jan 14, 2025
Nov 16, 2024
Nov 10, 2024
Nov 18, 2024
Dec 21, 2019
Sep 7, 2019
Sep 14, 2024
Sep 14, 2024
Dec 8, 2024
May 18, 2019
Jan 14, 2025
Sep 13, 2024
Nov 9, 2024
Jan 13, 2025
Sep 14, 2024
Sep 10, 2024

Repository files navigation

Actions Status

eduOS-rs - A teaching operating system written in Rust

Introduction

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. eduOS-rs is derived from following tutorials and software distributions:

  1. Philipp Oppermann's excellent series of blog posts.
  2. Erik Kidd's toyos-rs, which is an extension of Philipp Opermann's kernel.
  3. The original version of eduOS, which was the old teaching kernel written in C.
  4. eduOS-rs' uses a memory allocator, which is derived from the buddy_system_allocator.
  5. The first version of paging is derived from a version, which was developed by Colin Finck.

Requirements to build eduOS-rs

eduOS-rs is tested under Linux, macOS, and Windows.

macOS

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

In addition, Qemu must be installed. Please use Homebrew as package manager to install Qemu.

$ brew install qemu 

Windows

To build eduOS-rs you have to install Qemu and a git client. Please use Chocolatey as package manager to install Qemu and git.

$ choco install qemu git

Linux

Linux users should install common developer tools. For instance, on Ubuntu 22.04 the following command installs the required tools:

$ apt-get install -y git qemu-system-x86 build-essential

Common for macOS, Windows and Linux

This project uses Rustup to set its Rust toolchain. Follow the instructions to install Rust using Rustup.

In addition, the tool bootimage is required, which creates a bootable diskimage. Please install the tool with following command.

$ cargo install bootimage

Building

eduOS-rs is able to run within Qemu, which is a generic and open source machine emulator and virtualizer.

After cloning the repository, you can run the kernel with following command:

$ 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:

  1. stage0 - Smallest HelloWorld of the World

    Description of loading a minimal 64bit kernel

Useful Links

  1. http://www.gnu.org/software/grub/manual/multiboot/
  2. http://www.osdever.net/tutorials/view/brans-kernel-development-tutorial
  3. https://www.acs.eonerc.rwth-aachen.de/cms/e-on-erc-acs/studium/lehrveranstaltungen/~xwyom/grundgebiete-der-informatik-4-betriebs/?lidx=1
  4. http://rwth-os.github.io/eduOS/
  5. https://intermezzos.github.io

License

Licensed under either of

at your option.