Quickstart

This page will quickly walk you through building and running Prism.

Building Prism

Note

The default compiler for CentOS 7 and older (gcc <5) does not support C++14. Install and enable the offical Devtoolset before compiling.

Clone and build Prism from source:

$ git clone https://github.com/vandal/prism
$ cd prism
$ mkdir build && cd build
$ cmake3 .. # CentOS 7 requires cmake3 package
$ make -j

This creates a build/bin folder containing the prism executable. It can be run in place, or the entire bin folder can be moved, although it’s not advised to move it to a system location.

Running Prism

Prism requires at least two arguments: the backend analysis tool, and the executable application to measure:

$ bin/prism --backend=stgen --executable=./mybinary

The backend is the analysis tool that will analyze the requested events in mybinary. In this example, stgen is the backend that processes events into a special event trace that is used in SynchroTrace.

A third option frontend will change the underlying method for observing the application. By default, this is Valgrind:

$ bin/prism --frontend=valgrind --backend=stgen --executable=./mybinary

Dependencies

PACKAGE	VERSION
gcc/g++	5+
cmake	3.1.3+
make	3.8+
automake	1.13+
autoconf	2.69+
zlib/zlib-dev	1.27+
git	1.8+