📄 nanochess/bootOS/README

File: README.md | Updated: 11/18/2025

bootOS Documentation

Welcome to the bootOS documentation! bootOS is a monolithic operating system that fits entirely within a 512-byte boot sector.

Documentation Structure

This documentation is organized into the following sections:

Getting Started

Learn how to build, install, and run bootOS on your system or emulator.

Architecture

Understand the internal design and organization of bootOS.

API Reference

Complete reference for bootOS system interrupts and services.

User Guide

Learn how to use bootOS commands and run programs.

About bootOS

Version: 1.0 Author: Oscar Toledo G. Created: July 2019 License: See LICENSE file

bootOS is compatible with 8088 (the original IBM PC) and provides a complete operating system environment including:

  • File loading, execution, and saving
  • Filesystem management (up to 32 files)
  • Keyboard input and screen output services
  • Support for running boot sector programs at 0000:7c00

Links

Quick Example

# Build bootOS
nasm -f bin os.asm -l os.lst -o os.img

# Run with QEMU
qemu-system-x86_64 -fda os.img

Once running, try these commands:

$format
$ver
$dir

For more detailed information, explore the sections above.