Rust version of THU uCore OS. Linux compatible.
Go to file
Chen 66cb4181ec
Add maintenance notice
2023-08-24 21:46:33 +08:00
.github/workflows hypervisor: test hypervisor build in CI 2020-09-23 22:49:24 +08:00
crate/memory bugfix for race demand-page access. 2021-05-11 02:08:02 +08:00
docs Update x86_64.md 2021-05-07 20:33:07 +08:00
kernel bump rvm version and modify ffi 2021-05-17 11:04:31 +08:00
modules/hello_rust Bugfix: x86_64 module compilation failure (#20) 2019-10-10 01:43:37 +08:00
rboot@ea29a73dcf update rboot 2020-08-25 09:22:21 +08:00
tests Fix riscv32 testing 2019-05-03 15:17:06 +08:00
tools Recalibrating timer 2021-03-04 19:59:15 +08:00
user@1c5e883fcf bump rvm version. 2021-05-13 23:19:23 +08:00
.gitignore add utimensat, fix touch 2020-04-25 23:05:40 +08:00
.gitmodules submodule cleanup 2021-05-11 02:23:09 +08:00
LICENSE update LICENSE 2020-02-01 13:26:38 +08:00
README.md Add maintenance notice 2023-08-24 21:46:33 +08:00
rust-toolchain Bump to nightly-2020-06-04 and use llvm_asm instead of asm 2020-06-15 16:56:21 +08:00

README.md

rCore

CI

NO LONGER MAINTAINED. You can see recent developments in:

Rust version of THU uCore OS Plus.

Going to be the next generation teaching operating system.

Supported architectures and boards:

  • x86_64(Tier 1): QEMU, PC (i5/i7)
  • RISCV32/64(Tier 2): QEMU, HiFive Unleashed
  • AArch64(Tier 2): QEMU, Raspberry Pi 3B+
  • MIPS32(Tier 3): QEMU, TrivialMIPS

demo

What's included

rCore has the following features:

  • Linux compatible syscall interface: run Linux userspace programs
  • Network stack
  • Simple file system
  • Signal system
  • Async IO
  • Kernel module

Building

Environment

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