TotalView 5.0.0-5-LLNL

Release Features

July 8, 2002

TotalView is a product of Etnus, LLC.

This documents the release of TotalView 5.0.0-5-LLNL installed as tv5 and tv5cli on October 15, 2002, on blue/baby/snow/frost/sky/white, also gps/tc2k//sc.

On all Linux platforms, tv5 and tv5cli. are the Etnus binary releases of 5.0.0-5. The Etnus binary releases do not include any of the LLNL/LANL feature enhancements.

Below are the features added to the previous release in order to make TotalView 5.0.0-5.

Etnus 5.0.0-5 Release
§ Etnus release notes for 5.0.0-5
§ TotalView 5.0 Documentation -- Upgrading Guide, User's Guide, Window Descriptions, CLI Guide
§ Problems fixed in 5.0.0-5
LLNL Implemented New Features
§ Display of C++ STL vector, map, and list objects as arrays.
§ Typecast Caching (IBM platforms).
§ CLI (Command Line Interface): Statistics for C++ STL containers.
§ CLI: dmprint -- print multiple variables.
§ Default ActionPoint Saving.
§ No display of poe source window.
Previous and Future Releases
§ Previous LLNL/LANL Enhancements to TotalView
§ TotalView 6.1.0-2 Release Features

TotalView Debugger Tutorial by Blaise Barney
TotalView Quick Reference Page
TotalView CLI Summary Sheet

For problems/questions, send e-mail to Matt Wolfe, Bor Chan, Karen Warren (LLNL) or Laurie McGavran (LANL).

Display of C++ STL Container Types

The LLNL version of TotalView displays the vector, list, and map STL container objects as arrays for the IBM, KAI, Compaq, and gnu compilers.

Display of a list container that has not been transformed:

Display of a type transformed list contanier:

Display of transformed map container:

Caching of Type Casts

In order to increase efficiency, the typecasts of a variable made by the user are now cached (by default) and are used for subsequent dives on the given variable. This action can be turned off by using the Preferences->Options menu.

The cache can be completely purged at any time, or saved to a file, or loaded from that file by selecting the appropriate option on the Tools menu in the process window.
 >Purge Entire Type Cast Cache   --Removes every element associated with 
				   current debug target from the cache.   
 >Save Type-Cast Cache to File   --Generates 2 files: 
				   program name.TVD.breakpoints.cache 
				   and program name.TVD.breakpoints.index. 
				   The index file contains a unique key for
				   each process and offset in the cache file. 
				   Caches are unique to the process.   
 >Load Type-Cast Cache from File --Loads previously saved cache info into 
				   current debugging session.  If an element 
				   already exists in the cache, this operation 
				   overwrites it. 
				   Automatic cache loading is not yet supported.  

The data window Tools menu allows the user to remove that variable from the typecast cache, or, for debugging purposes, allows the user the print out all the cache elements in the current process cache.

CLI command to print statistics for C++ STL containers with integer or double types:

The following Command Line Interface commands are now available for printing statistics for STL containers with types of integer/double:

d1.<> stl_stat DoubleData
max at index ( 4 )  5.550000000000000e+01
mean. value of DoubleData = 35.5 
min at index ( 0 )  1.550000000000000e+01
sum value of DoubleData = 177.5 
std_dev value of DoubleData = 14.1421356237 

CLI command to print multiple variables: dmprint

The following Command Line Interface command is now available for printing more than one variable or expression:

d1.<> dmprint a x {b[2:5]}
 a = 0x00000016 (22)
 x = 3.1416
 b[2:5] = {
   [2] = 0x00000007 (7)
   [3] = 0x00000009 (9)
   [4] = 0x00000000 (0)
   [5] = 0x00000002 (2)
d1.<> dmprint "3*(a+2)"
  3*(a+2) = 0x00000048 (72)

Periodic ActionPoint Saving

Actionpoints are periodically saved and subsequently available for restarts and new runs. This default action may be turned off using the Preferences>Action Points menu.

No display of poe window.

Tcl script has been added to the global .tvdrc file to eliminate the display of the poe window for parallel runs.

LLNL Disclaimers