Support tools for CS194 Parallel Ruby GC

All these scripts expect to run on Linux and were tested on Ubuntu 12.04. You must have ccache, dot, gprof2dot.py, perf, and rvm on your PATH. For more useful output install debug symbols as well.

To install dependencies on Ubuntu 12.04 you can run scripts/install-ubuntu-12.04.sh or follow the manual instructions below.

On Ubuntu 12.04 you can install perf with

sudo apt-get install linux-tools-common linux-tools-`uname -r | sed 's/-generic//'`

To enable better samples on Linux use

sudo sysctl -w kernel.kptr_restrict=0

To make these settings persistent add the following lines to /etc/sysctl.conf.

kernel.kptr_restrict = 0

The profiling scripts use RVM to apply and remove patches. To install RVM see the install documentation or use

curl -L https://get.rvm.io | bash -s stable

On Ubuntu 12.04 use

sudo apt-get install graphviz

To install gprof2dot.py follow the instructions on their download page or use

mkdir -p ~/bin && \
curl -o ~/bin/gprof2dot.py http://gprof2dot.jrfonseca.googlecode.com/git/gprof2dot.py && \
chmod +x ~/bin/gprof2dot.py

ccache makes compile speeds tolerable. To install it on Ubuntu 12.04 use

sudo apt-get install ccache

To install debug symbols on Ubuntu 12.04 use

sudo apt-get install libc6-dbg