BenOS

BenOS is a minimalist, 16-bit, free and open-source x86 operating-system.

What is BenOS?

BenOS is a minimalist, 16-bit, free and open-source x86 operating-system, still in active development.

Why should you use BenOS?

Actually... you should not (as your main OS). Explaining: BenOS is not fully exploitable for now and is still in development. BenOS has not been tried on real hardware for now, so it is better to run in on an emulator.

Repository structure

The BenOS repository contains two branches:

• Main: the branch which contains the last finished version (recommended if you prefer stability)
• Indev: the branch which contains the last version in development. This branch is more updated than Main but can have more bugs and problems. If you find some, please make an Issue!

Build

This section contains informations about building the system. NOTE: the Windows and MacOS sections need contribution*

Linux

Automatic method

1. Clone this repository

git clone https://github.com/thebenos/benos

2. Install the required packages (example with APT)

# as root
apt update && apt install nasm mtools

3. Go inside the BenOS directory

cd benos

4. Enable execution for build.sh

chmod +x build.sh

5. Run build.sh

./build.sh

6. A file named "benos.img" should have been created!

Manual method

1. Clone this repository

git clone https://github.com/thebenos/benos

2. Install the required packages (example with APT)

# as root
apt update && apt install nasm

3. Go inside the BenOS directory

cd benos

4. Create a build directory

mkdir build

5. Compile the bootloader and the kernel

nasm -f bin build/bootloader.bin boot/bootloader.asm
nasm -f bin build/kernel.bin kernel/kernel.asm

6. Create the disk image

cat build/bootloader.bin build/kernel.bin /dev/zero | dd of=benos bs=512 count=2880 #status=none if you don't want to see the progress

7. A file named "benos" should have been created!

Windows

Contribution needed here

MacOS

Contribution needed here

Run on an emulator

This section teachs you how to run BenOS on an emulator named qemu.

qemu-system-x86_64 -drive format=raw,file=benos

BenOS should run.

How to contribute?

You can contribute here!