What is Bebok

A 64-bit kernel (and eventually an operating system) written in Zig, currently targeting x86_64, using Limine as a bootloader. I've been working on it for a while now, just for fun.

Name Origin

In Silesian language, a creature from our (Upper Silesians) demonology.

About Bebok

• Bebok is a basic version of an x64 operating system, crafted in Zig using the capabilities of the Limine bootloader.

Current Features :

• Ready-to-use features provided by Limine
• PMM (Physical Memory Manager) using Buddy Allocator for memory slices and AVL tree for entire memory regions
• Custom GDT (Global Descriptor Table) with kernel code and data segments, in addition to the default one provided by Limine
• IDT (Interrupt Descriptor Table) with basic handlers for Exceptions and LAPIC (Local Advanced Programmable Interrupt Controller)
• Basic terminal support in graphical mode using PC Screen Fonts (versions 1 and 2)
• PCI Express (Peripheral Component Interconnect Express) support
• MSI-X (Message Signaled Interrupts - Extended) support
• NVMe (Non-Volatile Memory Express) module (including driver, controller, etc.)
• Basic stream operations (read, write, seek) on block devices
• Partition schemes handling with GPT support (no CRC32 validation and no mirroring)
• VFS (Virtual File System) Basics: Initial implementation of the Virtual File System, providing a unified interface for interacting with different file systems.
• ext2 File System Support: Read-only support for ext2 file system, allowing access to files and directories in a read-only mode.
• Enhanced paging: remapping and downmapping (e.g. 2MB->4KB) support

In progress

• Ongoing refactoring and bug fixing
• Process management

Pre-requisites

Installed tools

• zig (master branch)
• qemu-img
• qemu-system-x86_64
• xorriso

Pre-run (only once)

Create an empty disk with GPT and ext2 partition with the create_disk.sh script

Script usage:

scripts/create_disk.sh                    

scripts/create_disk.sh <installation_prefix>

Requirements:

• Root privileges for losetup operations
• qemu-img, sgdisk, and mkfs.ext2 tools installed
• Target directory must be writable

Alternative:

You can use your own disk image if it has GPT and ext2 partition. In this case, place your disk.img in the installation directory.

How to run

zig build iso-qemu