TotalView Users Guide - CI Wiki

Starting TotalView
Debugging an MPI
Program
Using gnu_debuglink
Files
TotalView Individual does not allow remote debugging.
totalview executable
(method 1) In many cases, you can start an MPI program
in much the same way as you would start any other
program. However, you will need to select the Parallel
tab within the File > New Programs dialog box, and select
the MPI version in addition to other options.
mpirun -np count -tv executable
(method 2) The MPI mpirun command starts the
TotalView pointed to by the TOTALVIEW environment
variable. TotalView then starts your program. This program
will run using count processes.
totalview executable
If you have prepared a gnu_debuglink file, TotalView
can access this information. For more information, see
“Using gnu_debuglink Files” within the Compilers and
Platforms chapter of the TotalView Reference Guide.
Here’s where you can find more information:
� Debugging parallel programs such as MPI, PVM, or UPC, see Chapter 7,
“Setting Up Parallel Debugging Sessions,” on page 131.
� The totalview command, see “TotalView Command Syntax” in the TotalView
Reference Guide.
� Remote debugging, see “Setting Up and Starting the TotalView Server” on
page 81 and “TotalView Debugger Server (tvdsvr) Command Syntax” in the
TotalView Reference Guide.
Initializing TotalView
Starting TotalView
TotalView Variables
Saving Action Points to a File
When TotalView begins executing, it reads initialization and startup information
from a number of files. The two most common are initialization files that
you create and preference files that TotalView creates.
An initialization file is a place where you can store CLI functions, set variables,
and execute actions. TotalView interprets the information in this file whenever
it begins executing. This file, which you must name tvdrc, resides in the
.totalview subdirectory contained in your home directory. TotalView creates
this directory for you the first time it executes.
TotalView can actually read more than one initialization file. You can place
these files in your installation directory, the .totalview subdirectory, the
directory in which you invoke TotalView, or the directory in which the program
resides. If an initialization file is present in one or all of these places,
TotalView reads and executes each. Only the initialization file in your
.totalview directory has the name tvdrc. The other initialization files have
the name .tvdrc. That is, a dot precedes the file name.
56 Chapter 4: Setting Up a Debugging Session