Red Hat Developer Toolset 1.x User Guide - Linux

4 8 Chapter 8. Valgrind
Chapter 8. Valgrind
Valgrind is an instrumentation framework that ships with a number of tools to profile applications. It can
be used to detect various memory errors and memory management problems, such as the use of
uninitialized memory or improper allocation and freeing of memory, or to identify the use of improper
arguments in system calls. For a complete list of profiling tools that are distributed with the Red Hat
Developer Toolset version of Valgrind, refer to Table 8.1, “Tools Distributed with Valgrind for Red Hat
Developer Toolset”.
Valgrind profiles an application by rewriting it and instrumenting the rewritten binary. This allows you to
profile your application without the need to recompile it, but it also makes Valgrind significantly slower
than other profilers, especially when performing extremely detailed runs. It is therefore not suited to
debugging time-specific issues, or kernel-space debugging.
Red Hat Developer Toolset is distributed with Valgrind 3.8.1. This version is more recent than the
version included in Red Hat Enterprise Linux and provides numerous bug fixes and enhancements.
Table 8.1. Tools Distributed with Valgrind for Red Hat Developer Toolset
Name
Memcheck
Cachegrind
Callgrind
Helgrind
DRD
Massif
Description
Detects memory management problems by intercepting system calls and
checking all read and write operations.
Identifies the sources of cache misses by simulating the level 1 instruction
cache (I1), level 1 data cache (D1), and unified level 2 cache (L2).
Generates a call graph representing the function call history.
Detects synchronization errors in multithreaded C, C++, and Fortran
programs that use POSIX threading primitives.
Detects errors in multithreaded C and C++ programs that use POSIX
threading primitives or any other threading concepts that are built on top of
these POSIX threading primitives.
Monitors heap and stack usage.
8.1. Installing Valgrind
In Red Hat Developer Toolset, Valgrind is provided by the devtoolset-1.1-valgrind package, and is
automatically installed with devtoolset-1.1. If you intend to use Valgrind to profile parallel programs that
use the Message Passing Interface (MPI) protocol, install the devtoolset-1.1-valgrind-openmpi package.
For detailed information about how to install Red Hat Developer Toolset and related packages to your
system, refer to Section 1.5, “Installing Red Hat Developer Toolset”.
8.2. Using Valgrind
To run any of the Valgrind tools on a program you want to profile, type the following at a shell prompt:
scl enable devtoolset-1.1 'valgrind [--tool=tool] program [option...]'
Refer to Table 8.1, “Tools Distributed with Valgrind for Red Hat Developer Toolset” for a list of tools that
are distributed with Valgrind. The argument of the --tool command line option must be specified in
lower case, and if this option is omitted, Valgrind uses Memcheck by default. For example, to run
Cachegrind on a program to identify the sources of cache misses, type: