Hobby operating system for x86_64
Go to file
Bananymous aaf7a249c6 image: Add nicer error message if image could not be parsed 2024-06-17 22:58:59 +03:00
BAN BAN: Add network_endian_to_host 2024-06-17 22:14:43 +03:00
LibELF Kernel: Replace i386 with i686 2024-03-26 02:48:26 +02:00
LibFont LibFont: Move PSF code to separate file 2024-06-10 16:10:05 +03:00
LibGUI LibGUI: Mark Window's server fd as CLOEXEC and expose it through API 2024-06-03 18:01:34 +03:00
LibImage LibImage: Add image format probing 2024-06-17 22:14:43 +03:00
LibInput LibInput: Implement key_to_utf8_ansi 2024-06-03 17:52:43 +03:00
assets Update README.md 2023-08-31 17:54:12 +03:00
bootloader Bootloader: Implement better memset and memcpy for 32 bit addresses 2024-04-20 18:14:05 +03:00
kernel Kernel/LibC: Implement {get,set}sockopt() 2024-06-17 20:56:48 +03:00
libc LibC: Add dummy functions for rename() and strftime() 2024-06-17 21:02:37 +03:00
ports Ports: Add curl port! 2024-06-17 21:40:13 +03:00
script BuildSystem: Run kvm-ok to determine kvm access 2024-06-10 16:10:05 +03:00
toolchain LibC: Don't use BAN inside pwd.cpp 2024-05-29 19:12:15 +03:00
userspace image: Add nicer error message if image could not be parsed 2024-06-17 22:58:59 +03:00
.gitignore BuildSystem: using sysroot doesn't need root privileges anymore! 2023-11-04 17:50:43 +02:00
.gitmodules Kernel: Remove lai as a dependecy 2024-04-10 04:39:48 +03:00
.pre-commit-config.yaml General: Add simple contribution guide lines 2024-05-20 20:44:34 +03:00
CMakeLists.txt LibImage: Move userspace image parsing to its own library 2024-06-14 11:05:54 +03:00
LICENSE General: Rename LICENCE -> LICENSE 2024-04-03 15:59:30 +03:00
README.md Kernel: Implement read-only FAT12/16/32 driver with long name support 2024-06-14 01:04:12 +03:00
base-sysroot.tar.gz WindowServer: Add support for background images 2024-06-16 00:28:09 +03:00
bos BuildSystem: Add bos short hand for building with zsh completions :) 2023-10-28 22:23:29 +03:00

README.md

banan-os

This is my hobby operating system written in C++. Currently supports x86_64 and i686 architectures.

You can find a live demo here

Features

General

  • Ring3 userspace
  • SMP (multiprocessing)
  • Linear framebuffer (VESA and GOP)
  • Network stack
  • ELF executable loading
  • AML interpreter (partial)
  • ELF dynamic linking
  • Graphical desktop

Drivers

  • NVMe disks
  • ATA (IDE, SATA) disks
  • E1000 and E1000E NICs
  • PS2 keyboard (all scancode sets)
  • PS2 mouse

Network

  • ARP
  • ICMP
  • IPv4
  • UDP
  • TCP (partial and buggy)
  • Unix domain sockets

Filesystems

  • Virtual filesystem
  • Ext2
  • FAT12/16/32
  • Dev
  • Ram
  • Proc
  • Sys

Bootloader support

  • GRUB
  • Custom BIOS bootloader
  • Custom UEFI bootloader

screenshot from qemu running banan-os

Code structure

Each major component and library has its own subdirectory (kernel, userspace, libc, ...). Each directory contains directory include, which has all of the header files of the component. Every header is included by its absolute path.

Building

Needed packages

apt (tested on ubuntu 22.04)

# apt install build-essential git ninja-build texinfo bison flex libgmp-dev libmpfr-dev libmpc-dev parted qemu-system-x86 cpu-checker

pacman

# pacman -S --needed base-devel git wget cmake ninja parted qemu-system-x86

Compilation

To build the toolchain for this os. You can run the following command.

NOTE: The following step has to be done only once. This might take a long time since we are compiling binutils and gcc.

./bos toolchain

To build the os itself you can run one of the following commands. You will need root access for disk image creation/modification.

./bos qemu
./bos qemu-nographic
./bos qemu-debug
./bos bochs

You can also build the kernel or disk image without running it:

./bos kernel
./bos image

To build for other architectures set environment variable BANAN_ARCH=arch (e.g. BANAN_ARCH=i686).

To change the bootloader you can set environment variable BANAN_BOOTLOADER; supported values are BANAN (my custom bootloader) and GRUB.

To run with UEFI set environment variable BANAN_UEFI_BOOT=1. You will also have to set OVMF_PATH to the correct OVMF (default /usr/share/ovmf/x64/OVMF.fd).

If you have corrupted your disk image or want to create new one, you can either manually delete build/banan-os.img and build system will automatically create you a new one or you can run the following command.

./bos image-full

I have also created shell completion script for zsh. You can either copy the file in script/shell-completion/zsh/_bos to /usr/share/zsh/site-functions/ or add the script/shell-completion/zsh to your fpath in .zshrc.

Contributing

As the upstream is hosted on my server https://git.bananymous.com/Bananymous/banan-os, please contact me about account creation (email, discord) and I will add a account for you. This is done to limit the people with access to the server.

As this is mostly a learning experience for me, I would appreciate if you first contacted me about adding new features (email, discord, issue, ...). Bug fixes are always welcome!

Commit message should be formatted followingly

  1. First line is of the form "Subject: Description", where Subject tells the area touched (Kernel, Shell, BuildSystem, ...) and Description is brief description of the change done. First line should fit fully in 70 characters.
  2. Body of the message should further describe the change and reasoning behind the change.

All commits should pass the pre-commit hook defined in .pre-commit-config.yaml. For instructions on how to setup pre-commit, please see https://pre-commit.com/#install.