RobOS

RobOS is a custom hobby operating system written from scratch for the x86 architecture. It features a custom kernel, a basic shell, and a fully functional network stack capable of TCP/IP communication.

Features 🌟

• Custom Kernel: Written in C and Assembly.
• Networking Stack:
  • RTL8139 Driver
  • ARP, IP, ICMP (Ping), UDP
  • TCP Protocol (Handshake, SEQ/ACK management)
  • DNS Resolver
• Shell (CLI):
  • File management (ls, cat, touch, mkdir, edit)
  • Network utilities (ping, dns, http)
  • System tools (lspci, fcrash, reboot, poweroff)
• Filesystem: Custom implementation with basic read/write support.
• Graphics: VGA Text Mode with color support.

Getting Started 🚀

Prerequisites

To build and run RobOS, you need a Linux environment with the following tools installed:

• nasm (Assembler)
• gcc (Compiler, cross-compiler recommended but standard GCC works with -m64 -ffreestanding)
• ld (Linker)
• qemu-system-x86_64 (Emulator)

Building and Running

1. Clone the repository:

   git clone https://github.com/RobbyTSP/rolpb.git
   cd rolpb

2. Run the build script:

   ./run.sh

   This script will:

   • Clean previous builds.
   • Assemble the bootloader.
   • Compile the kernel and drivers.
   • Link everything into a bootable disk image (bin/os-image.bin).
   • Launch QEMU with network support.

Usage 🖥️

Once the OS boots, you will be greeted by the shell. Type help to see a list of available commands.

Example Commands:

• help - Show command list.
• ls - List files.
• ping 8.8.8.8 - Ping Google DNS.
• fcrash - Simulate a kernel panic (Red Screen of Death).

License 📄

This project is licensed under the GNU General Public License v3.0 (GPLv3). See the LICENSE file for details.

Copyright (C) 2026 Robby