8.1. Building a VM

Last updated 3 February 2014 for Self 4.5.0

The sources for the Self VM are on the GitHub repository.

8.1.1. Requirements

On Mac OS X you will need XCode, version 4 or higher, with the command line tools installed and CMake in at least version 2.8. CMake can be easily installed using the Brew package manager.

On Linux you will generally need the appropriate libraries for Git, CMake, a GCC or Clang toolchain, X and Ncurses. For example, on Fedora 19 you will need: git cmake gcc gcc-c++ glibc-devel.i686 libstdc++-devel libstdc++-devel.i686 libX11-devel.i686 libXt-devel.i686 libXext-devel.i686 libXrender-devel.i686 libXau-devel.i686 libxcb-devel.i686 ncurses-devel.i686 ncurses-libs.i686

Self builds with GCC ≥ 4.2 or Clang ≥ 2.0.

8.1.2. Building

You can do an in-tree build with:

cmake .
cmake --build .

or an out-of-tree build with:

cmake --build $YOU_BUILD_DIRECTORY

CMake respects your environment variables, so to build Self with Clang, configure it like this:


On Mac OS X with Xcode, you can use the Xcode generator of CMake like this:


On 64bit Linux, you may want to explicitly use 32bit compilation:

CC="gcc -m32" CXX="g++ -m32" cmake $DIRECTORY_OF_SELF_CHECKOUT

The same holds for Clang.

You may wish to use ccmake or the CMake GUI (cmake-gui or the CMake.app on OS X) to configure available features like Release/Debug/Profiled builds or to enable experimental features.