Cilk Plus Installation Guide
From SuperTech Wiki
Revision as of 13:27, 4 November 2013 by Tao Benjamin Schardl (Talk | contribs)
Intel provides a suite of tools for programming Cilk-based programs. The tool set contains the Intel compiler ICC, the parallelism checker Cilkview, the race condition reporter Cilkscreen, the binary-level instrumentation gadget Pintool, the fine-level instrumentation tool Cilkprof. Here is a guide to install them on a 64-bit Linux.
- Online Resources
- Open Source Cilk Plus Website: http://www.cilkplus.org/
- Installation
- Install ICC or GCC: You need a license from Intel® in order to install ICC. A free, open-source version is available in the cilkplus branch of GCC.
- Installing ICC: These instructions assume your shell is bash.
- Go to http://software.intel.com/en-us/articles/intel-software-evaluation-center/.
- Select the Linux version of "Intel® C++ Composer XE" (or any Linux product suite listed as containing "Intel® C++ Composer XE") and download the 64-bit version.
- Unpack the downloaded file and run the installation script.
-
$ /path/to/unpacked/file/install.sh
. - Note: To allow all users to access ICC on the system, run this install script as root.
-
- Follow the on-screen instructions to install ICC.
- Set up your environment variables to use ICC.
-
$ source /path/to/intel/bin/compilervars.sh intel64
.
-
- Installing GCC: These instructions walk you through checking out and building the cilkplus branch of GCC. Complete instructions for building GCC from source can be found at http://gcc.gnu.org/install/index.html. These instructions will install GCC into a custom directory,
gcc-cilk
, so as not to overwrite the existing version of GCC on your system.
- Warning: This process takes a while and uses a couple gigabytes of space.
- Check out the latest version of the cilkplus branch of GCC.
-
$ svn checkout svn://gcc.gnu.org/svn/gcc/branches/cilkplus gcc-cilk-src
- Note: I encountered problems with my connection timing out when I tried to check out the repository from http://gcc.gnu.org/svn/gcc/branches/cilkplus instead of svn://gcc.gnu.org/svn/gcc/branches/cilkplus. If you encounter similar problems, make sure you are using the "svn" protocol, instead of the "http" protocol. If you have previously checked out the gcc cilkplus source using "http," you can switch your checkout to use "svn" by running the following in the directory containing your checkout.
-
$ svn switch --relocate http://gcc.gnu.org/svn/gcc/branches/cilkplus svn://gcc.gnu.org/svn/gcc/branches/cilkplus
-
- Alternatively, you may check out the repository using git:
-
$ git clone git://gcc.gnu.org/git/gcc.git gcc-cilk-src
-
$ cd gcc-cilk-src
-
$ git checkout -b my_cilkplus_branch origin/cilkplus
-
$ cd ..
-
- Create two new directories,
gcc-cilk-obj
andgcc-cilk
, in the directory containinggcc-cilk-src
.-
$ mkdir gcc-cilk-obj gcc-cilk
-
- Install gmp, mpfr, and mpc on your system. Make sure you have also installed bison, flex, and isl. In general, check http://gcc.gnu.org/install/prerequisites.html for the list of necessary prerequisites.
- Configure GCC as follows:
-
$ cd gcc-cilk-obj
-
$ ../gcc-cilk-src/configure --prefix=../gcc-cilk --enable-languages=c,c++
- Note:: You may want to add
--disable-multilib
to the configuration options if multilib is not installed on your system. Otherwise, you may encounter errors such as: -
gnu/stubs-32.h: No such file or directory compilation terminated.
-
- Compile GCC:
-
$ make
-
- Install GCC into gcc-cilk:
-
$ make install
-
- The new GCC binary is
/path/to/gcc-cilk/bin/gcc
. - Set up environment!
-
$ export PATH=path/to/gcc-cilk/bin:$PATH
-
$ export LD_LIBRARY_PATH=path/to/gcc-cilk/lib
-
$ export LIBRARY_PATH=path/to/gcc-cilk/lib
-
- Install Cilkview Cilkscreen: Get it from here: http://software.intel.com/en-us/articles/intel-cilk-plus-software-development-kit/. The include bin directory in PATH.
- Install Pintool: Download pintool from here: http://www.pintool.org/downloads.html. Install.
- Install Cilkprof: You need Pin revision 53271 in order to run Cilkprof. These instructions include instructions on downloading and installing this version of Pin for Cilkprof.
- Change to the directory in which you would like to install Cilkprof.
- Create two new directories,
cilkutil
and3rdparty
.-
$ mkdir cilkutil 3rdparty
-
- Download Pin revision 53271 for Linux from http://www.pintool.org/downloads.html, and place the downloaded archive into
3rdparty
. - Download libzca from http://cilkplus.org/download, and place the downloaded archive into
cilkutil
. - Unpack the Pin archive inside of
3rdparty
. - Rename the folder created from unpacking the archive to
pintool
. - If you do not have the necessary permissions to access the
intel64
subdirectory inside ofpintool
, run$ chmod -R 755 intel64
. - Unpack the
libzca
archive inside of cilkutil. This will produce azca
directory and acilkprof
directory. - Ensure you have the necessary permissions on the unpacked archive directories, using
chmod
.-
$ chmod -R 755 *
-
- Build libzca.
-
$ cd zca/src
-
$ make OUT=linux64
-
- Build cilkprof.
-
$ cd ../../cilkprof
-
$ make
-
- Download the
cilkprof
script from http://web.mit.edu/neboat/www/code/cilkprof, and place it in a directory in yourPATH
environment variable. - Set the CILKUTIL environment variable to point to the
cilkutil
directory. For example, if your shell is bash, add the lineexport CILKUTIL=/path/to/cilkutil
to your.bashrc
.
- Usage
- Compile with ICC:
$ icc cilkprogram.cpp -o cilkprogram
- Compile with GCC:
$ g++ cilkprogram.cpp -o cilkprogram -lcilkrts -ldl
- Check parallelism:
$ cilkview ./cilkprogram
- Check race condition:
$ cilkscreen ./cilkprogram
- Pintool: TO BE COMPLETED
- Linux perf tool:
- Show list of counters:
$ perf list
- check L1 data load miss:
$ perf stat -c L1-dcache-load-misses ./cilkprogram
- Show list of counters:
- Cilkprof:
$ cilkprof ./cilkprogram
- This command generates two csv output files,
cilkprogram.bb.csv
andcilkprogram.cc.csv
, containing work and span profiling data for your Cilk program. At this time, the data in these files are most easily perused using your favorite spreadsheet program. For more information on configuring the output of Cilkprof, run$ cilkprof -h
.
- This command generates two csv output files,
- Compile with ICC: