Rust version of THU uCore OS Plus.
Going to be the next generation teaching operating system.
Supported architectures: x86_64, RISCV32/64, AArch64, MIPS32
Tested boards: QEMU, HiFive Unleashed, x86_64 PC (i5/i7), Raspberry Pi 3B+
- Rust toolchain at nightly-2019-03-05
- Cargo tools: cargo-xbuild
- QEMU >= 3.1.0
- bootimage (for x86_64)
- RISCV64 GNU toolchain (for riscv32/64)
- AArch64 GNU toolchain (for aarch64)
- musl-cross-make (for userland musl, or download prebuilt toolchain from musl.cc)
- libfuse-dev (for userland image generation)
See Travis script for details.
Install appropriate dependencies to Host:
$ rustup component add rust-src llvm-tools-preview
$ cargo install cargo-binutils --version 0.1.7
$ cargo install bootimage --version 0.5.7
#git clone cargo-xbuild from github, then checkout tag v0.5.6.
#Apply patch: https://github.com/rust-osdev/cargo-xbuild/pull/75/commits/eede1a1d4c08064763f1943c0920de2270260b33
#OR just pull: https://github.com/elliott10/cargo-xbuild.git
#When `cargo xbuild`, you can use a local `rust-src`:
#`export XARGO_RUST_SRC=~/.rustup/toolchains/nightly-2019-03-05-x86_64-unknown-linux-gnu/lib/rustlib/src/rust/src/`
$ cargo install cargo-xbuild --path /path/to/cargo-xbuild/
Run rCore:
$ git clone https://github.com/rcore-os/rCore.git --recursive
$ cd rCore/user
$ make sfsimg arch={riscv32,riscv64,x86_64,aarch64,mipsel} # requires $(arch)-linux-musl-gcc
$ cd ../kernel
$ make run arch={riscv32,riscv64,x86_64,aarch64,mipsel} mode=release
$ make run arch=x86_64 mode=release pci_passthru=0000:00:00.1 # for ixgbe real nic, find its pci (bus, dev, func) first
#eg: QEMU
$ make run arch=riscv32
#OR
$ make run arch=riscv64
#eg: k210 riscv64
$ make install arch=riscv64 board=k210 mode=debug
Module | Maintainer |
---|---|
x86_64 | @wangrunji0408 |
RISCV | @jiegec |
ARM (Raspi3) | @equation314 |
MIPS | @HarryChen @miskcoo |
Memory, Process, File System | @wangrunji0408 |
Network with drivers | @jiegec |
GUI | @equation314 |
This is a project of THU courses:
- Operating System (2018 Spring)
- Comprehensive Experiment of Computer System (2018 Summer)
- Operating System Train (2018 Autumn)
- Operating System (2019 Spring)
Reports and Dev docs (in Chinese)
It's based on BlogOS , a demo project in the excellent tutorial Writing an OS in Rust (First Edition).
The source code is dual-licensed under MIT or the Apache License (Version 2.0).