Troubleshooting - Rubinius
Author: Less Than Three. <3. http://less.thanthree.com
Description: Rubinius is an implementation of the Ruby programming language. The Rubinius bytecode virtual machine is written in C++. The bytecode compiler is written in pure Ruby. The vast majority of the core library is also written in Ruby, with some supporting primitives that interact with the VM directly.

1.2.3

## Troubleshooting

The following are errors that you may encounter while building, installing, or running Rubinius along with suggested solutions.

For any error, a first step is to ensure you have a current, clean checkout of Rubinius. Before going further, consider running the following steps:

    $ git co master
    $ git reset --hard
    $ git pull
    $ rake distclean
    $ rake

### Rubinius is unable to find the `runtime` directory

After building or installing, the following error occurs when attempting to run Rubinius:

    ERROR: unable to find runtime directory

    Rubinius was configured to find the runtime directory at:

      /Users/brian/devel/rubinius/runtime

    but that directory does not exist.

    Set the environment variable RBX_RUNTIME to the location
    of the directory with the compiled Rubinius kernel files.

    You may have configured Rubinius for a different install
    directory but you have not run 'rake install' yet.

#### Solution:

If you configured Rubinius with a `--prefix`, run rake install.

If you configured Rubinius with a `--prefix` and renamed the install directory after installing Rubinius, re-configure Rubinius and reinstall it.

If you renamed the source directory after building Rubinius, re-configure and rebuild it.

In general, do not rename the build or install directory after building or installing Rubinius.

### Rubinius segfaults when building on FreeBSD

On FreeBSD, including up to version 8.1 stable, there is an issue with execinfo that causes Rubinius to segfault when it loads.

#### Solution:

Disable execinfo when configuring Rubinius:

    ./configure --without-execinfo