45 lines
1.4 KiB
Markdown
45 lines
1.4 KiB
Markdown
# 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:
|
|
```bash
|
|
cd noxos
|
|
./build.sh
|
|
```
|
|
If the Bootloader (Limine ([github](https://github.com/limine-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.
|
|
|
|
# UEFI Emulation
|
|
To emulate an UEFI system, you need to install the `ovmf` package.
|
|
Then you can do `./run.sh uefi` to start qemu with uefi instead of 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`.
|
|
```bash
|
|
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) |