Skip to content

RustOS v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 May 06:15
· 113 commits to main since this release
v0.1.0
bf062f4

RustOS v0.1.0

Download

  • rustos-v0.1.0.img — raw x86_64 disk image (BIOS bootloader)

Booting from USB (recommended)

Write the image directly to a USB drive — this is the most reliable method:

Linux / macOS:

sudo dd if=rustos-v0.1.0.img of=/dev/sdX bs=4M status=progress && sync

Replace /dev/sdX with your USB device (e.g. /dev/sdb). Do NOT use a partition (e.g. /dev/sdb1).

Windows (Rufus): Open Rufus, select the .img file, choose "DD image" mode.

Then boot your PC from that USB drive. In your BIOS/UEFI settings, enable Legacy/CSM boot or BIOS compatibility mode (this kernel uses a BIOS bootloader; UEFI-only systems require CSM).

Testing in QEMU

qemu-system-x86_64   -drive format=raw,file=rustos-v0.1.0.img   -device qemu-xhci,id=xhci   -drive if=none,id=usbdisk,file=YOUR_FAT32_DISK.img,format=raw   -device usb-storage,bus=xhci.0,drive=usbdisk   -serial stdio

What's in this release

  • Interactive shell (help, ls, cd, cat, write, cp, mv, exec, usbscan, …)
  • ELF64 process loader — run programs from USB with exec /usb/yourprogram
  • USB mass storage (XHCI) — plug in a USB drive and run usbscan to mount it at /usb
  • FAT32 read support for USB drives
  • VGA text mode, async keyboard input
  • Heap allocator, interrupt handling (IDT/GDT/PIC)
Assets 3
Loading