Skip to content
Branch: master
Clone or download
BSC Performance Tools
BSC Performance Tools Upgrade to v3.6.1
Latest commit 2034671 Sep 19, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config
docs Adds missing CUDA wrappers and callbacks for the creation and destruc… May 29, 2018
etc Fixes race condition when issuing install in a parallel make Sep 17, 2018
example
include Adds extrae_module.f90 to distribution May 18, 2018
scripts
src
tests Adds missing CUDA wrappers and callbacks for the creation and destruc… May 29, 2018
.gitignore Patched IO calls to save/restore the value of errno at entry/exit of … Nov 9, 2016
AUTHORS
COPYING Changes COPYING file to reflect the correct license (LGPL) Oct 14, 2016
ChangeLog
INSTALL
INSTALL-examples Removed support for CELL. Oct 5, 2015
Makefile.am New documentation using sphinx-doc Jul 13, 2017
NEWS
PATHS Add initial PEBS sampling support Jun 23, 2015
README Clarify README file to push to GitHub Sep 22, 2016
RELEASE-PROCEDURE Add some comments Mar 15, 2016
TODO Updated Jul 16, 2010
bootstrap
bootstrap-and-dist No commit message Jun 25, 2014
configure.ac
substitute
substitute-all

README

Extrae
======

A dynamic instrumentation package to trace programs compiled and run with the
shared memory model (like OpenMP and pthreads), the message passing (MPI)
programming model or both programming models (different MPI processes using
OpenMP or pthreads within each MPI process). **Extrae** generates trace files
that can be later visualized with **Paraver**.


Optional dependencies
---------------------

Please, make sure to install the development versions of all packages (-dev,
-devel) when available.

* [libunwind (>=1.0)](http://www.nongnu.org/libunwind)  
	Used to access the callstack within **Extrae**. This lets the analyst gather
	MPI call-sites and emit information on manually added events. Required for
	Intel x86_64 and ia64 architectures.
* [PAPI](http://icl.cs.utk.edu/papi)  
	Used to access the HW counters of the microprocessor. This increases the
	richness of the gathered traces. It is highly recommended to install and use
	PAPI with extrae, altough on some old kernels this may require patching.
* **libiberty and libbfd** (from the binutils package)  
	These two libraries are required to translate gathered application addresses
	into source code information (file name, address line and function name).
	Highly recommended.
* [libxml2 (>=2.5.0)](http://www.xmlsoft.org)  
	Used to parse the configuration of the instrumentation package instead of
	using environment variables. Highly recommended.
* [Dyninst](http://www.dyninst.or)  
	Support is in experimental status. It is known to work on Linux PPC32/64
	systems and on Linux x86/x86_64 systems.
* [libz](http://www.zlib.net)  
	libiberty and libbfd may require libz. Also libz may be used to generate
	compressed traces directly.
* **MPI**  
  Execute MPI jobs. Tested with MPICH, MPICH2 and OpenMPI. Others may work.
* **OpenMP** runtime (gcc, ibm or icc)  
	Execute OpenMP jobs.
* **CUDA** / **CUPTI**  
	Execute CUDA-based applications.
* **OpenCL**  
	Execute OpenCL-based applications.


Installation instructions
-------------------------

Refer to the [INSTALL](./INSTALL) file for general installation instructions.  
Refer to the [INSTALL-examples](./INSTALL-examples) fill for examples of
specific installation instructions.
You can’t perform that action at this time.