Bananymous
3f2e110eab
I used to only initialize devices, but now I send ACPI_ENABLE if machine is not hardware reduced. |
||
---|---|---|
BAN | ||
LibELF | ||
assets | ||
bootloader | ||
kernel | ||
libc | ||
ports | ||
script | ||
toolchain | ||
userspace | ||
.gitignore | ||
.gitmodules | ||
CMakeLists.txt | ||
LICENSE | ||
README.md | ||
base-sysroot.tar.gz | ||
bos |
README.md
banan-os
This is my hobby operating system written in C++. Currently supports x86_64 and i686 architectures.
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
- Dev
- Ram
- Proc
- Sys
Bootloader support
- GRUB
- Custom BIOS bootloader
- Custom UEFI bootloader
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
pacman
# pacman -S --needed base-devel git wget cmake ninja parted qemu-system-x86
NOTE: You need cmake version of atleast 2.26. If you are using cmake that is not found from PATH, you can set the CMAKE_COMMAND environment variable to point to the correct cmake binary. Or you can let build script download correct version of cmake if you don't have one.
When you clone this reposity, make sure to also clone submodules. This can be done by cloning with the command git clone --recurse-submodules https://git.bananymous.com/bananymous/banan-os.git
or if you have already cloned this repo, run git submodule init && git submodule update
.
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
Currently I don't accept contributions to this repository unless explicitly told otherwise. This is a learning project for me and I want to do everything myself. Feel free to fork/clone this repo and tinker with it yourself.