You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
123 lines
6.0 KiB
123 lines
6.0 KiB
# rCore-user
|
|
|
|
[](https://travis-ci.org/rcore-os/rcore-user)
|
|
|
|
User programs for [rCore OS](https://github.com/rcore-os/rCore).
|
|
|
|
|
|
Now it has 4 parts:
|
|
|
|
* `ucore`: C-lang, from the original [ucore_os_lab](https://github.com/chyyuu/ucore_os_plus)
|
|
* `biscuit`: C/C++, from [Biscuit](https://github.com/mit-pdos/biscuit), based on a `musl` instead of original `litc`.
|
|
* `rust`: Simple no_std Rust programs.
|
|
* `nginx`, `redis`, `busybox`, `alpine`: Real world applications.
|
|
|
|
## Build
|
|
|
|
To build biscuit programs, install musl toolchain first:
|
|
|
|
```bash
|
|
# 1. to download prebuilt binaries in Linux, visit [musl.cc](https://musl.cc)
|
|
# 2. to build musl toolchains from source:
|
|
# 2.1 for macOS musl toolchain for x86_64(,aarch64)
|
|
$ brew install FileSottile/musl-cross/musl-cross {--with-aarch64}
|
|
# 2.2 for ubuntu 16.04, we should build gcc-musl for newest musl-1.1.21, please see build-gcc-musl.md for instructions
|
|
# 2.3 for riscv musl toolchain, please install [musl-riscv-toolchain](https://github.com/jiegec/musl-riscv-toolchain)
|
|
```
|
|
|
|
Then, build userspace programs for rCore:
|
|
|
|
```bash
|
|
$ make {ucore,biscuit,rust,nginx,redis,all} arch={x86_64,aarch64,riscv32,riscv64}
|
|
$ make alpine arch={x86_64,aarch64} # if you want to use alpine rootfs
|
|
$ make sfsimg arch={x86_64,aarch64,riscv32,riscv64}
|
|
```
|
|
|
|
A rootfs is created at `build/$(arch)` and converted to `qcow2`.
|
|
|
|
## Support matrix
|
|
|
|
| | x86_64 | aarch64 | riscv32 | riscv64 |
|
|
| ------------------ | ------ | ------- | ------- | ------- |
|
|
| ucore | ❌ | ✅ | ✅ | ✅ |
|
|
| rust | ✅ | ✅ | ✅ | ✅ |
|
|
| biscuit | ✅ | ✅ | ❌ | ✅ |
|
|
| nginx (linux only) | ✅ | ✅ | ❌ | ✅ |
|
|
| redis (linux only) | ✅ | ✅ | ✅ | ❌ |
|
|
| busybox | ✅ | ✅ | ❌ | ✅ |
|
|
| alpine rootfs | ✅ | ✅ | ❌ | ❌ |
|
|
|
|
|
|
|
|
## How to use Redis
|
|
|
|
If redis is dynamically linked to musl (default if you use commands above), you might need to copy `ld-musl-$(arch).so.1` to rootfs `/lib` . Alpine rootfs includes one as well.
|
|
|
|
After building redis, you should be able to run redis-server in rCore. Then, start `redis-server` in rCore:
|
|
|
|
```bash
|
|
/> redis-server redis.conf
|
|
```
|
|
|
|
Then you should be able to connect to it using `redis-cli` over the network:
|
|
|
|
```bash
|
|
$ redis-cli -h 10.0.0.2 get abc
|
|
(nil)
|
|
$ redis-cli -h 10.0.0.2 set abc def
|
|
OK
|
|
$ redis-cli -h 10.0.0.2 get abc
|
|
"def"
|
|
```
|
|
|
|
Note: `redis-cli` in rCore is not working at the time.
|
|
|
|
## How to use nginx
|
|
|
|
Nginx is statically linked to musl instead, so there is no need to copy its dynamic loader. A nginx.conf is provided in this repo and automatically copied to its destination. So, just start `nginx` directly:
|
|
|
|
```bash
|
|
/> nginx
|
|
```
|
|
|
|
Then you should be able to visit it via network:
|
|
|
|
```bash
|
|
$ curl http://10.0.0.2/
|
|
<html>
|
|
<head><title>Index of /</title></head>
|
|
<body bgcolor="white">
|
|
<h1>Index of /</h1><hr><pre><a href="../">../</a>
|
|
<a href="bin/">bin/</a> 01-Jan-1970 00:00 -
|
|
<a href="biscuit/">biscuit/</a> 01-Jan-1970 00:00 -
|
|
<a href="dev/">dev/</a> 01-Jan-1970 00:00 -
|
|
<a href="etc/">etc/</a> 01-Jan-1970 00:00 -
|
|
<a href="home/">home/</a> 01-Jan-1970 00:00 -
|
|
<a href="lib/">lib/</a> 01-Jan-1970 00:00 -
|
|
<a href="media/">media/</a> 01-Jan-1970 00:00 -
|
|
<a href="mnt/">mnt/</a> 01-Jan-1970 00:00 -
|
|
<a href="opt/">opt/</a> 01-Jan-1970 00:00 -
|
|
<a href="proc/">proc/</a> 01-Jan-1970 00:00 -
|
|
<a href="root/">root/</a> 01-Jan-1970 00:00 -
|
|
<a href="run/">run/</a> 01-Jan-1970 00:00 -
|
|
<a href="rust/">rust/</a> 01-Jan-1970 00:00 -
|
|
<a href="sbin/">sbin/</a> 01-Jan-1970 00:00 -
|
|
<a href="srv/">srv/</a> 01-Jan-1970 00:00 -
|
|
<a href="sys/">sys/</a> 01-Jan-1970 00:00 -
|
|
<a href="tmp/">tmp/</a> 01-Jan-1970 00:00 -
|
|
<a href="usr/">usr/</a> 01-Jan-1970 00:00 -
|
|
<a href="var/">var/</a> 01-Jan-1970 00:00 -
|
|
<a href="busybox">busybox</a> 01-Jan-1970 00:00 1141024
|
|
<a href="nginx">nginx</a> 01-Jan-1970 00:00 741288
|
|
<a href="nginx-remote">nginx-remote</a> 01-Jan-1970 00:00 762440
|
|
<a href="nginx.conf">nginx.conf</a> 01-Jan-1970 00:00 99
|
|
<a href="redis-cli">redis-cli</a> 01-Jan-1970 00:00 221256
|
|
<a href="redis-server">redis-server</a> 01-Jan-1970 00:00 1120888
|
|
<a href="redis.conf">redis.conf</a> 01-Jan-1970 00:00 18
|
|
</pre><hr></body>
|
|
</html>
|
|
```
|
|
|
|
It is generated by `autoindex`.
|
|
|
|
Note: `nginx` might lead to an unresolved file system bug, so you might need to re-create sfs img after killing it. |