Go to file
Bananymous db5c24b2a5 BAN: Implement ByteSpan
This is a span over exisiting containers/data types. I'm not too
happy with the constructors and assignment operators, but they will
work for now
2023-10-20 04:59:29 +03:00
BAN BAN: Implement ByteSpan 2023-10-20 04:59:29 +03:00
LibELF Kernel: Check whether ELF address space can be loaded 2023-10-12 22:59:36 +03:00
assets Update README.md 2023-08-31 17:54:12 +03:00
kernel Kernel: Map multiboot2 memory in PageTable initialization 2023-10-17 01:15:08 +03:00
libc Kernel: Add physical memory info to /proc/{pid}/meminfo 2023-09-30 22:11:45 +03:00
toolchain BAN: add helper to cast Span<T> to Span<const T> 2023-10-20 04:59:08 +03:00
userspace Shell: Fix parsing $ with unknown character 2023-10-12 22:24:27 +03:00
.gitignore BuildSystem: add cmake variable UEFI_BOOT 2023-10-16 01:44:54 +03:00
.gitmodules Kernel: Add LAI as a dependency 2023-09-22 17:20:35 +03:00
CMakeLists.txt BAN: add helper to cast Span<T> to Span<const T> 2023-10-20 04:59:08 +03:00
LICENCE Create LICENCE 2023-04-13 00:38:24 +03:00
PreLoad.cmake BuildSystem: Rework calling qemu 2023-09-27 13:49:01 +03:00
README.md BuildSystem: Rework calling qemu 2023-09-27 13:49:01 +03:00
base-sysroot.tar.gz BuildSystem: add cmake variable UEFI_BOOT 2023-10-16 01:44:54 +03:00
bochs.sh All: Clear lines with only whitspace in them 2023-09-10 00:31:42 +03:00
check-fs.sh BuildSystem: Add cmake target to validate main partition 2023-08-31 21:37:30 +03:00
image-full.sh BAN: add helper to cast Span<T> to Span<const T> 2023-10-20 04:59:08 +03:00
image.sh BuildSystem: add cmake variable UEFI_BOOT 2023-10-16 01:44:54 +03:00
qemu.sh 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, 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.

You can and should pass cmake variable QEMU_ACCEL set to proper accelerator to cmake commands. For example on Linux this means adding -DQEMU_ACCEL=kvm to the end of all cmake commands.

Create the build directory and cofigure cmake

mkdir build
cd build
cmake ..

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.

ninja toolchain
cmake --fresh .. # We need to reconfigure cmake to use the new compiler
ninja libstdc++

To build the os itself you can run either of the following commands. You will need root access since the sysroot has "proper" permissions.

ninja qemu
ninja bochs

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

ninja kernel
ninja image

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

ninja image-full

NOTE ninja clean has to be ran with root permissions, since it deletes the root filesystem.

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.