1.5 KiB
| title | summary |
|---|---|
| Build Instructions | Instructions for setting up the workspace and building noxos |
DISCLAIMER: To build this project you need a linux system (WSL could work for windows users, but I haven't tested it)
First you need to clone the repository:
git clone https://git.nerdcult.net/noxos/kernel
then there are a few tools required, that need to be installed:
- gcc - compiler
- ld - linker
- nasm - assembler
- cmake - build system
- xorriso - ISO creation tools
- qemu - emulator
- ovmf - UEFI firmware
you can check if you have all tools installed, with ./build.sh check.
There is a shell script to setup the workspace and compile. Just run it using the following commands:
cd noxos
./build.sh
If the Bootloader (limine) isn't downloaded yet, the script will download it.
The final ISO file will be written to the build directory.
To launch the ISO, run the run.sh script.
BIOS Emulation
To emulate a BIOS system, you can run ./run.sh bios.
Debugging
Logs
When running through the script, qemu is configured to write the kernels logs to STDOUT and a file called noxos.log.
GDB
You can connect GDB to qemu.
To achieve this, run ./run.sh debug.
QEMU will wait until you connect GDB to it as a 'remote' target on localhost:1234.
gdb build/cmake/kernel/kernel
target remote localhost:1234
c
(note, that the last to commands have to be 'executed' in gdb not in your shell)