Hobby operating system for x86_64
Go to file
Bananymous 50ca2ac09e Bootloader: Interpret 0x7F (DEL) as backspace
This allows backspace to work over qemu's serial connection
2024-01-03 11:58:50 +02:00
BAN BAN: Make StringView::split const and fix bug with empties 2024-01-03 00:14:29 +02:00
LibELF Kernel: Appreciate setuid and setgid bits executables 2023-12-06 18:14:27 +02:00
assets Update README.md 2023-08-31 17:54:12 +03:00
bootloader Bootloader: Interpret 0x7F (DEL) as backspace 2024-01-03 11:58:50 +02:00
kernel Kernel: Add some helpful debug prints 2024-01-03 02:08:01 +02:00
libc LibC: Implement basic atexit. This allows clean exit from doom (soon) 2024-01-03 00:30:37 +02:00
script BuildSystem: Add instructions + fixes to build system 2023-12-28 21:37:18 +02:00
toolchain BuildSystem: Use git apply instead of am 2023-12-28 20:16:36 +02:00
userspace ls: Write group name instead of gid in list mode 2024-01-03 00:15:13 +02:00
.gitignore BuildSystem: using sysroot doesn't need root privileges anymore! 2023-11-04 17:50:43 +02:00
.gitmodules Kernel: Add LAI as a dependency 2023-09-22 17:20:35 +03:00
CMakeLists.txt All: Start work again on sse support 2023-12-28 19:14:42 +02:00
LICENCE Create LICENCE 2023-04-13 00:38:24 +03:00
README.md README: Add packages required by compilation in pacman 2023-12-29 03:11:30 +02:00
base-sysroot.tar.gz Kernel: Implement supplementary groups 2024-01-02 23:24:32 +02:00
bos BuildSystem: Add bos short hand for building with zsh completions :) 2023-10-28 22:23:29 +03:00

README.md

license

banan-os

This is my hobby operating system written in C++. Currently supports only x86_64 architecture. We have a ext2 filesystem, basic ramfs, IDE disk drivers in ATA PIO mode, ATA AHCI drivers, userspace processes, executable loading from ELF format, linear VBE graphics and multithreaded processing on single core.

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

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.

./script/build.sh toolchain

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

./script/build.sh qemu
./script/build.sh qemu-nographic
./script/build.sh qemu-debug
./script/build.sh bochs

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

./script/build.sh kernel
./script/build.sh image

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.

./script/build.sh image-full

If you feel like ./script/build.sh is too verbose, there exists a symlink bos in this projects root directory. All build commands can be used with ./bos args... instead.

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.