banan-os/README.md

51 lines
2.5 KiB
Markdown
Raw Normal View History

2023-04-19 00:46:42 +03:00
![license](https://img.shields.io/github/license/bananymous/banan-os)
2023-03-18 04:05:59 +02:00
# banan-os
2023-04-06 20:59:45 +03:00
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.
2023-08-31 17:54:12 +03:00
![screenshot from qemu running banan-os](assets/banan-os.png)
## 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.
2023-04-06 21:01:27 +03:00
2023-04-06 20:59:45 +03:00
## Building
2023-08-31 17:54:12 +03:00
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.
2023-04-06 20:59:45 +03:00
To build the toolchain for this os. You can run the following command.
2023-08-31 17:54:12 +03:00
> ***NOTE:*** The following step has to be done only once. This might take a long time since we are compiling binutils and gcc.
2023-04-06 20:59:45 +03:00
```sh
./script/build.sh toolchain
2023-04-06 20:59:45 +03:00
```
To build the os itself you can run one of the following commands. You will need root access since the sysroot has "proper" permissions.
2023-04-06 20:59:45 +03:00
```sh
./script/build.sh qemu
./script/build.sh qemu-nographic
./script/build.sh qemu-debug
./script/build.sh bochs
2023-04-06 20:59:45 +03:00
```
You can also build the kernel or disk image without running it:
```sh
./script/build.sh kernel
./script/build.sh image
2023-04-06 20:59:45 +03:00
```
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.
2023-04-06 20:59:45 +03:00
```sh
./script/build.sh image-full
2023-04-06 20:59:45 +03:00
```
2023-08-31 17:54:12 +03:00
> ***NOTE*** ```ninja clean``` has to be ran with root permissions, since it deletes from the banan-so sysroot.
2023-08-31 17:54:12 +03:00
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_.
2023-08-31 17:54:12 +03:00
### 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.