Blog OS

This repository contains the source code for the Writing an OS in Rust series at os.phil-opp.com.

Building

You need a nightly Rust compiler and the cargo-xbuild and bootimage tools. You can install the tools by executing the following command:

cargo install cargo-xbuild bootimage

Afterwards you can invoke bootimage build to produce a bootable disk image. Please file an issue if you run into any problems.

To run the image in QEMU, you can execute bootimage run. Note that you need to have QEMU installed.

Posts

The goal of this project is to provide step-by-step tutorials in individual blog posts. We currently have the following set of posts:

Bare Bones

• A Freestanding Rust Binary
• A Minimal Rust Kernel
• VGA Text Mode

Testing

• Unit Testing
• Integration Tests

Interrupts

• CPU Exceptions
• Double Faults
• Hardware Interrupts

First Edition Posts

The current version of the blog is already the second edition. The first edition is outdated and no longer maintained, but might still be useful. The posts of the first edition are:

Bare Bones

• A Minimal x86 Kernel (source code)
• Entering Long Mode (source code)
• Set Up Rust (source code)
• Printing to Screen (source code)

Memory Management

• Allocating Frames (source code)
• Page Tables (source code)
• Remap the Kernel (source code)
• Kernel Heap (source code)

Exceptions

• Handling Exceptions (source code)
• Double Faults (source code)

Additional Resources

• Cross Compile Binutils
• Cross Compile libcore
• Set Up GDB
• Handling Exceptions using Naked Functions
  • Catching Exceptions (source code)
  • Better Exception Messages (source code)
  • Returning from Exceptions (source code)

License

The source code is dual-licensed under MIT or the Apache License (Version 2.0). This excludes the blog directory.