Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A fork of rustboot focusing on ARM functionality and aiming to extend it into a more fully functional kernel. Setup instructions below cribbed also from rustboot.


You need a few things to run ironkernel:

  1. rust-core
  2. Rust's master branch or 0.9 release
  3. qemu
  4. llvm
  5. binutils for arm-none-eabi
  6. Optionally for debugging
  • gdb
  • tmux

Clone this repository and update rust-core.

$ git clone
$ cd ironkernel
$ git submodule update --init
### you can also pull latest rust-core:
$ git submodule foreach git pull origin master

Arch Linux

Simply install all dependencies:

# pacman -S base-devel qemu rust llvm tmux
# yaourt -S arm-none-eabi-gcc

Note that you will want Rust 0.9 and LLVM 3.4


To set things up on OSX, do this:

Install nasm and qemu from homebrew:

$ brew install nasm
$ brew install qemu


Install binutils from source.

tar xzvf binutils-2.23.2.tar.gz
cd binutils-2.23.2
export ARMTOOLS=~/arm-none-eabi
./configure --target=arm-none-eabi --prefix=$ARMTOOLS
make all install

To get edge Rust going, grab it from git:

$ git clone
$ cd rust
$ ./configure
$ make && make install

Running it

You may have to make some small changes before it builds. Namely, you may need to adjust the rust prefix in the makefile (I did). Hopefully nothing else. To compile, simply execute make command.

To run, use:

$ make run	# emulate default platform (ARM)
$ make debug # debug on arm