tree os v2

@biosfood biosfood authored on 15 Jan
rootfs/boot/ grub find the initrd in the multiboot 2 information structure 1 year ago
src shell: scan for terminal function 3 months ago
.clang-format initial commit 1 year ago
.gitignore enable interrupts 1 year ago
LICENSE initial commit 1 year ago
Makefile enable qemu scisi debug logging 5 months ago
README.md add more detail to README 3 months ago
compile_flags.txt fix compile flags to prevent errors 1 year ago
dependencies add dependencies file 6 months ago
honey-os.png add screenshot 1 year ago
honey-os.sfdisk make honey-os.img more recognizable 6 months ago
link.ld use ld-level allocation of allocation data object for all programs and kernel 7 months ago
README.md

Honey OS

Honey os is an open suorce operating system and kernel.

Building

The ┬┤dependencies┬┤ file contains a list of AUR packages that should be installed when runnung Honey-OS. To install them all, use your package manager (paru in this example) like this:

cat dependencies | paru -S -

To build the OS and run in an emulator, run

make

Sometime when modifying hlib, things can break. In this event, clear all build files using

make clean

and try building honey-os again.

Directory structure

The rootfs directory contains all files for the 'root file system' of the final iso. It contains the final honey os kernel executable file as well as necessary grub configuration files.

The initrd directory will be created during the building process as a temporary directory. This is later packed into a .tar file and will be loaded by grub. After booting, the kernel will be able to load additional user mode programs from this 'initial ramdisk', before other file system drivers have been initialized to load programs from the boot drive.

src/kernel contains all files which are compiled into the finished kernel.

src/userland contains several directories with source files to compile different ELF user programs. The Makefile at src/userland/Makefile and the accompanying src/userland/link.ld are the default method of building the userland files. The compiled binary will have the same name as the folder its source files are located in, so source files in src/userland/shell/ will all be compiled and linked into an ELF file at initrd/shell, then packed into rootfs/initrd.tar and then inserted into the .iso file.

All userspace programms are currently loaded into the virtual address 0x80000000 by default, but honey-os principally supports loading them anywhenre.

The compiled object files for userland programs are stored in src/userland/build/

src/hlib is the honey OS utility library. It is linked by default with all loaded user mode programs at a high memory address (0xFF000000). And can be linked with and assumed to be loaded by any other program, because it will be loaded first.

src/include has some .h that are shared by all userspace programs and supported by hlib.