mirror of https://github.com/rcore-os/rCore.git synced 2024-11-25 09:26:17 +04:00

Rust version of THU uCore OS. Linux compatible.

Go to file

Chen 92df488bf5 Merge pull request #51 from rcore-os/halt-quit-qemu-zero		2020-05-11 12:35:24 +08:00
.github/workflows	update Rust nightly to 2020-04-06	2020-04-06 17:19:05 +08:00
crate	Flush I/D cache after copying user code in page fault handler	2019-10-04 14:05:20 +08:00
docs	x86_64: switch from legacy BIOS to UEFI. use rboot as new bootloader	2019-09-04 10:37:31 +08:00
kernel	Let halt quit QEMU with zero exit code	2020-05-11 12:13:49 +08:00
modules/hello_rust	Bugfix: x86_64 module compilation failure (#20 )	2019-10-10 01:43:37 +08:00
rboot@048fa09b6b	update Rust nightly to 2020-04-06	2020-04-06 17:19:05 +08:00
tests	Fix riscv32 testing	2019-05-03 15:17:06 +08:00
tools	Bump rboot and user commit, update Cargo.lock and fix addr2line.py	2020-01-29 10:59:39 +08:00
user@1bdaf05bb3	Bump rcore-user version	2020-04-05 00:18:44 +08:00
.gitignore	Basic loadable kernel module support, with a module template written in Rust.	2019-06-07 20:59:51 +08:00
.gitmodules	x86_64: switch from legacy BIOS to UEFI. use rboot as new bootloader	2019-09-04 10:37:31 +08:00
LICENSE	update LICENSE	2020-02-01 13:26:38 +08:00
README.md	uppercase arguments in Makefile	2020-02-01 13:25:55 +08:00
rust-toolchain	update Rust nightly to 2020-04-06	2020-04-06 17:19:05 +08:00

README.md

rCore

Rust version of THU uCore OS Plus.

Going to be the next generation teaching operating system.

Supported architectures and boards:

x86_64: PC (i5/i7)
RISCV32/64: HiFive Unleashed, Kendryte K210, FPGA running Rocket Chip
AArch64: Raspberry Pi 3B+
MIPS32: TrivialMIPS

Building

Environment

Rust toolchain
QEMU >= 4.1.0
musl-based GCC toolchains (only for building user programs)

Setup on Linux or macOS:

$ rustup component add rust-src llvm-tools-preview

Or use Docker container:

$ docker run -it -v $PWD:$PWD -w $PWD wangrunji0408/rcore

How to run

$ git clone https://github.com/rcore-os/rCore.git --recursive
$ cd rCore/user
$ make sfsimg prebuilt=1 arch=x86_64
$ cd ../kernel
$ make run ARCH=x86_64 LOG=info

See Makefile for more usages.

Maintainers

Module	Maintainer
x86_64	@wangrunji0408
RISC-V	@jiegec
ARM (Raspi3)	@equation314
MIPS	@Harry_Chen @miskcoo
Memory, Process, File System	@wangrunji0408
Network with drivers	@jiegec
GUI	@equation314

History

This is a project of THU courses:

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

License

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