orbfidelicura/orb
Apache-2.0N/A
Well-documented implementation of RISC-V kernel in Zig, built on QEMU emulation.
1100
View program on GitHub4
kernel,qemu,risc-v,zig
README
Description
Heavily commented code with detailed explanations on implementation of the
real-time unikernel, designed for the [RISC-V]. It is built upon generic virtual
platform [virt] of the [QEMU] emulation software. Tested only on [Linux].
Prerequisites
* [Zig] programming language (0.15.2)
* [QEMU] emulation software (10.1.0)
* [Just] command runner (1.40.0)
* (optional) [GDB] code debugger (16.3)
Building
Use `just` command to see the available recipes list.
Most of the time, only `just build` recipe is used.
Debugging
Use `just dbg` to run a [QEMU] instance with enabled debugging ports,
then `just gdb` to [GDB] into the currently running code.
Hint: source `helper.gdb` script in a running [GDB] session for easy
to use printing capabilies of the relevant debugging information.
Roadmap
See `ROADMAP` file in the repository root.
Links
[QEMU]: https://qemu.org
[virt]: https://qemu.org/docs/master/system/riscv/virt.html
[Linux]: https://www.kernel.org
[Zig]: https://ziglang.org
[Just]: https://just.systems
[GDB]: https://gnu.org/software/gdb
[GNU]: https://gnu.org
[GCC]: https://gcc.gnu.org