How cirosantilli/x86-bare-metal-examples works
This repository is an educational catalog of minimal x86 bare-metal programs, not one operating system. The main workflow is to choose an example and launch it in QEMU or Bochs; the README also describes writing images to hardware and booting a combined GRUB image. Examples cover BIOS services, CPU modes and interrupts, and alternate Multiboot and UEFI entry points. The excerpts show selected C examples and shared assembly macros; most individual examples and alternate boot configurations are represented only by their paths and README descriptions, so their internal calls are not inferred.
Main entry points: run Example runner · bios_hello_world.S BIOS programs · bios_putc.S BIOS display and input · bios_disk_load.S BIOS disk loading
Components 18
BIOS examples
- BIOS programs
bios_hello_world.S - BIOS display and input
bios_putc.S - BIOS disk loading
bios_disk_load.S - C BIOS hello
c_hello_world/main.c
CPU and interrupts
- Protected mode
protected_mode.S - Segmentation
segmentation.S - Paging
paging.S - Interrupt handling
interrupt.S - Keyboard interrupts
interrupt_keyboard.S - PIT and RTC
pit.S
Alternate boot
- Multiboot hello
multiboot/hello-world/main.c - Multiboot OS kernel
multiboot/osdev/kernel.c - UEFI application
uefi/main.c - GRUB chainloader
grub/chainloader/iso/boot/grub/grub.cfg - GRUB Linux boot
grub/linux/iso/boot/grub/grub.cfg
Shared runtime
- Assembly macros
common.h
Other components
- Learner
- Example runner
run
Connections 4
- Learner → Example runner: chooses example
README.adoc - Example runner → BIOS programs: launches example
README.adoc - Example runner → BIOS display and input: launches example
README.adoc - Example runner → BIOS disk loading: launches example
README.adoc