Hobby operating system for x86_64
Go to file
Bananymous b7007016c0 BAN: Implement Ext2 file unlinking
Ext2 inodes can now be unlinked from directories and after last
inode closes (destructor gets called) we check if link count is 0
and cleanup the inode from filesystem
2023-10-25 21:43:36 +03:00
BAN BAN: ByteSpan can be sliced without specified size 2023-10-25 21:41:11 +03:00
LibELF Kernel: Rewrite all read/write functions to use BAN::ByteSpan 2023-10-24 11:56:00 +03:00
assets Update README.md 2023-08-31 17:54:12 +03:00
kernel BAN: Implement Ext2 file unlinking 2023-10-25 21:43:36 +03:00
libc Kernel/LibC/Userspace: Implement mkdir and creat 2023-10-25 21:07:26 +03:00
script BuildSystem: Fix bugs in new build system 2023-10-24 16:48:46 +03:00
toolchain BuildSystem: Fix bugs in new build system 2023-10-24 16:48:46 +03:00
userspace Kernel/LibC/Userspace: Implement mkdir and creat 2023-10-25 21:07:26 +03:00
.gitignore BuildSystem: Fix bugs in new build system 2023-10-24 16:48:46 +03:00
.gitmodules Kernel: Add LAI as a dependency 2023-09-22 17:20:35 +03:00
CMakeLists.txt Kernel/LibC/Userspace: Implement mkdir and creat 2023-10-25 21:07:26 +03:00
LICENCE Create LICENCE 2023-04-13 00:38:24 +03:00
README.md BuildSystem: Match README.md with the new buildsystem 2023-10-24 11:56:00 +03:00
base-sysroot.tar.gz BuildSystem: add cmake variable UEFI_BOOT 2023-10-16 01:44:54 +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 read-only ext2 filesystem, read-write 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

There does not exist a complete list of needed packages for building. From the top of my head I can say that cmake, ninja, make, grub, rsync and emulator (qemu or bochs) are needed.

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 since the sysroot has "proper" permissions.

./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

NOTE ninja clean has to be ran with root permissions, since it deletes from the banan-so sysroot.

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.