Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rikeyone/mini-os
This is a Mini OS based on Linux include kernel/rootfs and some essential libraries and daemons.
https://github.com/rikeyone/mini-os
applications kernel-driver linux-distribution rootfs
Last synced: about 1 month ago
JSON representation
This is a Mini OS based on Linux include kernel/rootfs and some essential libraries and daemons.
- Host: GitHub
- URL: https://github.com/rikeyone/mini-os
- Owner: rikeyone
- Created: 2019-03-11T08:08:40.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-12T19:20:01.000Z (6 months ago)
- Last Synced: 2024-09-29T15:04:34.451Z (about 1 month ago)
- Topics: applications, kernel-driver, linux-distribution, rootfs
- Language: C
- Size: 157 KB
- Stars: 13
- Watchers: 3
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Description
MiniOS is a develop environment for linux kernel and applications using QEMU virtual machine. Developers can easily clone it and develop based on it. You can make your idea to an product very quickly using MiniOS environment. It is a good choice to verify your solutions on MiniOS before production.
# Install Environment
```
sudo ./install.sh
```
It will install compile toolchains of arm and arm64, and qemu environment.
# Build MiniOS
To build MiniOS system:
```
./build.sh [-a][-m module][-p platform]
```
Options:
```
-a: build all modules.
-m: build expect module:kernel/rootfs/busybox/libc/initramfs.
-p: build platform, support arm and arm64, default is arm64.
-h: help informations.
```
# Build Samples
- Default platform arm64:
To build full MiniOS system [platform: arm64]:
```
./build.sh -a
```
To build MiniOS modules [platform:arm64]:
```
./build.sh -m {MODDULE}
```
the module has these values to choose: kernel, rootfs, busybox, libc, initramfs.
BTW, the rootfs module will include "libc", "initramfs" and "busybox" build.
eg:
```
./build.sh -m rootfs #compile arm64 platform rootfs module
./build.sh -m kernel #compile arm64 platform kernel module
```
- arm platform
To build full MiniOS system [platform: arm]:
```
./build.sh -a -p arm
```
To build MiniOS modules [platform:arm]:
```
./build.sh -m {MODDULE} -p arm
```
the module has these values to choose: kernel, rootfs, busybox, libc, initramfs.
BTW, the rootfs module will include "libc", "initramfs" and "busybox" build.
eg:
```
./build.sh -m rootfs -p arm #compile arm64 platform rootfs module
./build.sh -m kernel -p arm #compile arm64 platform kernel module
```
# Run MiniOS
```
sudo ./run.sh
```
This command will run default arm64 minios system. If you build an arm platform minios,
you should add option to tell run.sh script:
```
sudo ./run.sh -p arm
```
# Stop MiniOS
```
sudo ./run.sh -s
```
This command will stop default arm64 minios system. If you want to stop an arm platform minios,
you should add option to tell run.sh script:
```
sudo ./run.sh -s -p arm
```
There is another important feature of minios, it support NFS as rootfs to boot linux kernel.
Using this feature, we can easily debug our applications without rebuilding the whole system:
```
sudo ./run.sh -t nfs -p arm
```
or
```
sudo ./run.sh -t nfs
```
# Advance Info
MiniOS kernel support list: linux-4.0/linux-4.9.
MiniOS busybox support list: busybox-1.24.0/busybox-1.30.0.
If you want to build the specific versions of kernel or busybox, just export env variables
to change kernel and busybox version to build, such as:
```
export BUSYBOX=busybox-1.30.0
export LINUX_KERNEL=linux-4.0
```
If no env variable is exported, the script will use default versions to build.