Muk -- A Rust Microkernel
This repository contains a toy microkernel that contains a minimalist kernel and can be used as a starting point to explore the aarch64 architecture. Please see also the licencing information.
Building
You need a rust install, see https://rust-lang.org. When installed, enable
Rust nightly and add std sources:
rustup toolchain install nightly
rustup default nightly
rustup component add rust-src
For building and executing, you also need lld, llvm, clang and GNU Make. If you are on Debian or a derivative such as Ubuntu/Mint, execute:
sudo apt install llvm lld clang build-essential qemu-system-arm
Then install cargo-xbuild which will build the core crate for aarch64:
cargo install cargo-xbuild
Development
For convenience, a Makefile is used to invoke cargo-xbuild and qemu. Use make
for building and make qemu for running the kernel.
Using make qemu DEBUG=1, QEMU is spawned with an open socket for GDB. Use
scripts/kernel.gdb to attach to it.