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 | 1.27+ |
git | 1.8+ |