Olympos

An experimental 32-bit Operating System.

Prerequisites

Before building Olympos, you need to have the following tools installed:

Required Packages

For Arch Linux:

# Core build tools
sudo pacman -S gcc make nasm

# For creating and running ISO
sudo pacman -S mtools xorriso grub qemu

# For debugging
sudo pacman -S gdb

For other distributions, install the equivalent packages using your package manager.

Cross-Compiler

You need a cross-compiler targeting i686-elf.

For Arch Linux Users

The cross-compiler can be easily installed from the AUR

yay -S i686-elf-gcc

For Other Distributions

If you're not using Arch Linux, you'll need to build the cross-compiler from source or find equivalent packages for your distribution.

Building

1. Clone the repository:

git clone <repository-url>
cd olympos

2. Build the system:

./build.sh

3. Create a bootable ISO:

./iso.sh

Running

To run Olympos in QEMU:

./qemu.sh

Debugging

Olympos includes support for debugging the kernel with GDB:

./debug.sh

Testing

Olympos includes a comprehensive integration test framework that runs tests in QEMU and verifies output through the serial port.

Quick Start

To run all tests:

./test.sh

For more information, see the test framework documentation.

Build System Scripts

• build.sh: Main build script
• clean.sh: Removes all built files
• config.sh: Configure build environment
• headers.sh: Install system headers
• iso.sh: Create bootable ISO
• qemu.sh: Run OS in QEMU
• debug.sh: Run OS in QEMU with GDB attached

License

The GNU General Public License v3.0