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