Skip to content

hikalium/liumos

main
Switch branches/tags
Code

liumOS

CircleCI License: MIT

Screenshot

A toy operating system which supports NVDIMM natively.

Requirements

Common

Install Rust toolchain

Check the installation (below is an example output):

$ cargo --version
cargo 1.46.0 (149022b1d 2020-07-17)

Then, install nightly toolchain and cargo-xbuild for cross compiling.

rustup toolchain install nightly-x86_64-unknown-linux-gnu
rustup component add rust-src

macOS

brew install wget cmake qemu llvm dosfstools

Ubuntu 20.04

sudo apt install wget cmake qemu-system-x86 clang-8 lld-8 libc++-8-dev libc++abi-8-dev clang-format

Prepare tools and libraries

Move to the root of this source tree. Then:

make tools
make prebuilt

How to build

make

Run on QEMU

This repository contains OVMF binary for UEFI emulation.

make run

You can connect serial console using telnet

telnet localhost 1235

Run flags

Flags can be specified for make run command. Please check qemu.mk for more details.

Example:

make run GUI=n GDB=nosuspend
  • GUI
    • =y: Enable GUI
    • =n: Disable GUI (enable VNC server)
  • GDB
    • =n: Disable gdb server in QEMU
    • =suspend_on_boot: Enable gdb server and wait for a connection on startup
    • =nosuspend: Enable gdb server and startup the machine normally without waiting for a gdb connection

Setup tap interface (for linux)

make run boots liumOS on QEMU with a tap interface on Linux host. To avoid running QEMU with sudo, you need to setup a tap interface in advance.

sudo ip tuntap add dev tap0 mode tap user $USER
sudo ip link set dev tap0 master br0
sudo ip link set dev tap0 up

example output with bridge br0 connected to eno1

$ ip a | grep -e br0 -e tap0
2: eno1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq master br0 state UP group default qlen 1000
4: br0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
    inet 10.10.10.93/24 brd 10.10.10.255 scope global dynamic br0
6: tap0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel master br0 state UP group default qlen 1000

Setup bridge interface

global, persistent

network:
  ethernets:
    eno1:
      dhcp4: false
      dhcp6: false
  bridges:
    br0:
      interfaces: [ eno1 ]
      dhcp4: true
  version: 2

How to contribute

Contributions are welcome! Please create a pull request to this repository.

Before submitting a PR, please check the test results with make test.

make commit does all the presubmit checks and creates a commit automatically (recommended!)

If you found any problems or questions, please let us know through Issues on GitHub.

References

Author

hikalium