Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rcore-os/rcore
Rust version of THU uCore OS. Linux compatible.
https://github.com/rcore-os/rcore
aarch64 mips osdev riscv rust x86-64
Last synced: 2 days ago
JSON representation
Rust version of THU uCore OS. Linux compatible.
- Host: GitHub
- URL: https://github.com/rcore-os/rcore
- Owner: rcore-os
- License: mit
- Created: 2018-04-02T07:29:49.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-08-24T13:46:34.000Z (over 1 year ago)
- Last Synced: 2024-12-13T07:04:51.197Z (9 days ago)
- Topics: aarch64, mips, osdev, riscv, rust, x86-64
- Language: Rust
- Homepage:
- Size: 11.9 MB
- Stars: 3,495
- Watchers: 84
- Forks: 378
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rCore
[](https://github.com/rcore-os/rCore/actions)
NO LONGER MAINTAINED. You can see recent developments in:
-
-
-
-
Rust version of THU [uCore OS Plus](https://github.com/chyyuu/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](https://github.com/Harry-Chen/TrivialMIPS)
## 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
* [Rust](https://www.rust-lang.org) toolchain
* [QEMU](https://www.qemu.org) >= 4.1.0
* [musl-based GCC toolchains](https://musl.cc/) (only for building [user programs](https://github.com/rcore-os/rcore-user))
Setup on Linux or macOS:
```bash
$ rustup component add rust-src llvm-tools-preview
```
Or use Docker container:
```bash
$ docker run -it -v $PWD:$PWD -w $PWD wangrunji0408/rcore
```
### How to run
```bash
$ 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](kernel/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:
* [Operating System (2018 Spring)](http://os.cs.tsinghua.edu.cn/oscourse/OS2018spring/projects/g11)
* [Comprehensive Experiment of Computer System (2018 Summer)](http://os.cs.tsinghua.edu.cn/oscourse/csproject2018/group05)
* [Operating System Train (2018 Autumn)](http://os.cs.tsinghua.edu.cn/oscourse/OsTrain2018)
* [Operating System (2019 Spring)](http://os.cs.tsinghua.edu.cn/oscourse/OS2019spring/projects)
* [Operating System Train (2019 Autumn)](http://os.cs.tsinghua.edu.cn/oscourse/OsTrain2019)
* [Operating System (2020 Spring)](http://os.cs.tsinghua.edu.cn/oscourse/OS2020spring/projects)
[Reports](./docs) and [Dev docs](https://rucore.gitbook.io/rust-os-docs/) (in Chinese)
It's based on [BlogOS](https://github.com/phil-opp/blog_os) , a demo project in the excellent tutorial [Writing an OS in Rust (First Edition)](https://os.phil-opp.com/first-edition/).
## License
The source code is dual-licensed under MIT or the Apache License (Version 2.0).