To compile this plugin, you need:
-
C compiler
-
CMake
-
Score-P (or VampirTrace)
-
A recent Linux kernel (
2.6.31+
) with activated tracing and the kernel headers
-
Delete the existing build directory and create your own:
rm -r build mkdir build cd build
-
Invoke CMake
Specify the Score-P (and/or VampirTrace) directory if it is not in the default path with
-DSCOREP_DIR=<PATH>
(respectivly-DVT_INC=<PATH>
). The plugin will use alternatively the environment variablesSCOREP_DIR
(andVT_DIR
), e.g.cmake .. -DSCOREP_DIR=/PATH/TO/scorep
or (for VampirTrace)
cmake .. -DVT_DIR=/PATH/TO/vampirtrace
-
Invoke make
make
-
Copy it to a location listed in
LD_LIBRARY_PATH
or add current path toLD_LIBRARY_PATH
withexport LD_LIBRARY_PATH=$LD_LIBRARY_PATH:`pwd`
To use this plugin you have to add it to the SCOREP_METRIC_PLUGINS
variable, e.g.:
export SCOREP_METRIC_PLUGINS=perf_plugin
Afterwards you can select the metrics you want to measure from the list of the available metrics using
export SCOREP_METRIC_PERF_PLUGIN=<metric name>
See below for a list of available metrics.
Name | estimation fomula |
---|---|
energy-thread | 1.602416e-9instructions-9.779874e-11cycles+6.437730e-08*cache_misses+2.418160e+03 |
power-energy-cores | RAPL*scale |
...... | ...... |
E.g.
export SCOREP_METRIC_PERF_PLUGIN=power-energy-cores
-
Check whether the plugin library can be loaded from the
LD_LIBRARY_PATH
. -
If your kernel headers do not provide the file
include/linux/perf_events.h
please make sure you are using at least Linux2.6.31
. -
Write a mail to the author.
- Xiaosha Xing (xiaosha.xing at tu-dresden dot de)