Zekri OS

A modern, custom operating system built from scratch with a focus on performance, security, and elegant design.

Project Structure

ZekriOS/
├── boot/              # Bootloader files
│   ├── boot.asm       # Multiboot2 entry point
│   └── grub.cfg       # GRUB configuration
├── kernel/            # Kernel source code
│   ├── main.c         # Kernel entry point
│   ├── arch/          # Architecture-specific code (GDT, IDT)
│   └── mm/            # Memory management (PMM, VMM, Heap)
├── build/             # Compiled object files (generated)
├── iso/               # ISO staging directory (generated)
├── Makefile           # Build configuration
├── build.sh           # Linux/WSL build script
├── build.bat          # Windows build script
├── linker.ld          # Linker script
└── zekrios.iso        # Final bootable ISO (generated)

Features

Implemented

• ✅ Multiboot2 Bootloader - GRUB-compatible boot system
• ✅ Memory Management
  • Physical Memory Manager (PMM) with bitmap allocator
  • Virtual Memory Manager (VMM) with paging support
  • Kernel heap allocator (kmalloc/kfree)
• ✅ Interrupt Handling
  • Global Descriptor Table (GDT)
  • Interrupt Descriptor Table (IDT)
  • CPU exception handlers
• ✅ VGA Text Mode - Basic console output

Planned

• 🔄 Process scheduler
• 🔄 File system (ZFS-Z)
• 🔄 Device drivers
• 🔄 Graphical user interface (ZekriShell)
• 🔄 System calls and userspace

Building

Prerequisites

Windows

1. Install WSL (Windows Subsystem for Linux):

   wsl --install

2. Restart your computer
3. Open Ubuntu from Start Menu and set up username/password
4. Install build tools:

   sudo apt update
   sudo apt install build-essential nasm grub-pc-bin grub-common xorriso mtools git -y

Linux

sudo apt install build-essential nasm grub-pc-bin grub-common xorriso mtools git -y

Build Commands

Windows

Simply double-click build.bat or run:

build.bat

Linux/WSL

chmod +x build.sh
./build.sh

Or use make directly:

make          # Build ISO
make clean    # Clean build files
make run      # Build and run in QEMU

Running

QEMU (Recommended)

qemu-system-i386 -cdrom zekrios.iso -m 512M

Or use the Makefile:

make run

VirtualBox

1. Create a new VM (Type: Other, Version: Other/Unknown)
2. Allocate at least 512MB RAM
3. Attach zekrios.iso as a CD-ROM
4. Boot the VM

Real Hardware (Advanced)

1. Write the ISO to a USB drive:

   sudo dd if=zekrios.iso of=/dev/sdX bs=4M status=progress

2. Boot from the USB drive

Documentation

See the Master Design Document for detailed architecture and design specifications.

License

This project is for educational purposes.

---

Zekri OS - Built with passion for operating system development.