<< >> Title Contents Index Home Help

4 Debugging with
TotalView


HPF source-level symbolic debugging of PGHPF programs is supported using the TotalView multi-process debugger. TotalView is available from Etnus, Inc. on the IBM RS6000/SP, SGI Origin and compatibles, and Sun E10000 and compatibles. A PGHPF-compatible version of TotalView is available from Cray Research on the CRAY T3E as of release PE 3.0.

4.1 Using Etnus TotalView

Using the version of TotalView from Etnus, you can:

* See a source-level display of your HPF program

* Examine values in a distributed array

* Visualize a distributed array

* Visualize the distribution of a distributed array

* Set and run to HPF source-level breakpoints

* Automatically update all values of a replicated scalar

There are still a number of limitations, including:

* Display of user-defined data types is not yet supported

* Next, Step, and Run work locally on a single process, not simultaneously on all processes

* Eval is executed locally and cannot reference distributed arrays

To build a PGHPF program for debugging with Etnus Totalview, you must compile and link using the -g and -Mtotalview switches to the pghpf compilation driver.

% pghpf -g -Mtotalview myprog.F

The commands used to start up Totalview vary from platform to platform. A typical invocation on 4 processors of an SGI Origin for an HPF program compiled with shared-memory communications options (-Mrpm or -Msmp) would look as follows:

% totalview a.out -pghpf -np 4

A typical invocation on 4 processors of an IBM RS6000/SP for an HPF program compiled with default communications options (-Mmpi) would look as follows:

% mpirun -tv -np 4 a.out

For information on how to invoke Totalview on a specific platform and for a complete list of features and how to use them, refer to the TotalView Multiprocess Debugger User's Guide.

4.2 Using Cray TotalView

Using the CRAY T3E version of TotalView from the Cray Research Division of SGI, you can:

* Debug HPF or HPF_CRAFT programs

* See a source-level display of your HPF or HPF_CRAFT program

* Examine values in a distributed array

* Visualize a distributed array

* Set and run to HPF source-level breakpoints

* Update all values of variables

* Debug at the command level (no GUI) using the -L option to Totalview

To build a PGHPF program for debugging with Cray Totalview, you must compile and link using the -g switches to the pghpf compilation driver. For example:

% pghpf -g myprog.F

To start up Totalview for debugging of an HPF program, you must pass the -pghpf switch upon invoking the debugger. For example:

% totalview -pghpf a.out

For more information on features of Cray Totalview and how to use them, refer to the Totalview man page on the CRAY T3E.


<< >> Title Contents Index Home Help