Building eduOS-rs

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 18.04 the following command installs the required tools:

$ apt-get install -y git nasm 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 https://github.com/rust-osdev/bootimage[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

  2. stage1 - Cooperative/non-preemptive multitasking

    Introduction into a simple form of multitasking, where no interrupts are required.

  3. stage2 - Priority-based cooperative/non-preemptive multitasking

    Introduction into a simple form of priority-based multitasking, where no interrupts are required.

  4. stage3 - Synchronization primitives

    Introduce basic synchronization primitives

  5. stage 4 - Preemptive multitasking

    Introduction into preemptive multitasking and interrupt handling

  6. stage 5 - Support of user-level tasks

    Add support of user-level tasks with an small interface for basic system calls

  7. stage 6 - Support of paging

    Add support of paging and a simple demo for process creation

  8. stage 7 - Integration of an in-memory file system

    Introduce a virtual file system with an in-memory file system as example file system.

  9. 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.