1.3 KiB
Build instructions
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://codeberg.org/antifallobst/noxos/
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
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 (github)) 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.
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)