rCore/README.md

rCore Plus

Rust version of THU uCore OS Plus.

Its former repo name is https://github.com/oscourse-tsinghua/RustOS .

Going to be the next generation teaching operating system.

Supported architectures: x86_64, RISCV32/64, AArch64, MIPS(future)

Tested boards: QEMU, labeled-RISCV, K210, Raspberry Pi 3B+

Dev docs (in Chinese)

Building

Environment

• Rust toolchain at nightly-2019-02-16
• Cargo tools: cargo-xbuild
• QEMU >= 3.1.0
• bootimage (for x86_64)
• RISCV64 GNU toolchain (for riscv32/64)
• AArch64 GNU toolchain (for aarch64)

See Travis script for details.

How to run

rustup component add rust-src
cargo install cargo-xbuild bootimage

git clone https://github.com/oscourse-tsinghua/rcore_plus.git --recursive
cd rcore_plus/kernel
make run arch={riscv32,riscv64,x86_64,aarch64}

History

This is a project of THU courses:

• Operating System (2018 Spring)
• Comprehensive Experiment of Computer System (2018 Summer)
• Operating System Train (2018 Autumn)

Project wiki (internal access only): OS, CECS, OST

Reports (in Chinese): docs

It's based on BlogOS , a demo project in the excellent tutorial Writing an OS in Rust (First Edition).

License

The source code is dual-licensed under MIT or the Apache License (Version 2.0).