A tiny 32 bit kernel written in Rust, for fun
Rust Assembly
Pull request Compare This branch is 84 commits ahead, 48 commits behind charliesome:master.
Latest commit e92e2ea Jan 27, 2014 @jvns Update README.md
Failed to load latest commit information.
src Whitespace test for Travis Dec 17, 2013
.gitignore Make src/ and build/ directories Dec 4, 2013
.gitmodules Fix .gitmodules Dec 17, 2013
.travis.yml Add .travis.yml Dec 17, 2013
LICENSE.txt because lawyers May 26, 2013


Build Status

Warning: This doesn't compile right now for anyone except me. When the Travis build above is passing, you will know that this is fixed. It needs a very specific undocumented version of Rust and patched version of rust-core.

I will also probably not fix it unless I start working on this again.


A tiny 32-bit kernel written in Rust, for fun. Splashing in puddles is fun but often impractical, and your feet get wet. unless you wear boots.

This has also been my experience with OS programming.

Fork of rustboot. Uses rust-core, a library that lets Rust programs run freestanding.

What it does

Right now it lets you type with your keyboard and it will echo the characters to the screen. And there's memory allocation! Here's a video of typing!.


You need a few things to run rustboot:

  1. qemu
  2. a cross-compiler for i386
  3. nasm
  4. Rust's incoming branch.


To set things up on OSX, do this:

Install nasm and qemu from homebrew:

$ brew install nasm
$ brew install quemu

Install binutils from source.

I personally keep things I manually compile limited to my home directory, so I use the --prefix=/Users/steve option. Put this wherever you want, of course.

$ wget 'ftp://sourceware.org/pub/binutils/snapshots/binutils-2.23.52.tar.bz2'
$ ./configure --target=i386-elf --prefix=/Users/steve
$ make && make install

To get Rust, you can either use one of the nightly builds for Linux or compile it from source.

To compile Rust, grab it from git:

$ git clone https://github.com/mozilla/rust
$ cd rust
$ git checkout incoming
$ ./configure --prefix=/Users/steve
$ make && make install

Same thing about the prefix applies.

Then, just make sure that ~/bin is in your PATH, if you're using a prefix.

Running it

To compile, simply

$ make

To run,

$ make run