This Reference Guide describes all of the commands and variables supported by the TotalView debugging engine. Everything described is supported in the Command Line Interface (CLI), which can be run in a command terminal, and is also available in the Command Line view of NextGen TotalView for HPC. However, many commands relate to functionality that does not appear in the NextGen TotalView for HPC interface. So while you can issue these commands and determine their effect through other CLI commands, you may not see any result reflected in the NextGen UI.
Note also that this release of NextGen TotalView for HPC supports a limited number of platforms. See the document Supported Platforms, either on the Rogue Wave web site or in the product distribution, for specific information.
The table that follows provides general guidance on the functionality that NextGen TotalView for HPC supports.
Supported by the New UI
Not Supported by the New UI
Most commands related to basic debugging actions for stepping through code
Parallel debugging environments such as MPI, OpenMP, and HPC systems
Attaching to a running process
Remote debugging
Debugging with core files
Memory debugging with MemoryScape
Breakpoints. Other action points such as watchpoints are not supported.
CUDA debugging
Many commands for examining and manipulating the data in variables
Xeon Phi debugging
TotalView startup options unless they relate to unsupported functionality such as parallel and remote debugging
Custom thread and process groups
Reverse debugging with ReplayEngine, including Replay on Demand and the saving and loading of recording files
Assembly code debugging including the display of the contents of registers
The information in this guide is organized in parts:
• Part I, Using the CLI contains descriptions of all the CLI commands, the variables that you can set using the CLI, and other CLI-related information.
• Part II, Transformations discusses formatting and transformations that display data in a clear and concise format to facilitate easier debugging sessions.
• Part III, Running TotalView documents all possible command-line options as well as those that customize the behavior of the tvdsvr.
Resources
Please see The Resources appendix in the User Guide for more information on:
• a complete list of TotalView for HPC documentation
• conventions used in the documentation
• contact information
The documentation for TotalView for HPC could be useful if you are using features not yet supported in the NextGen TotalView for HPC UI by invoking commands through the Command Line Interface (CLI). The commands themselves are described in this Reference Guide, but the TotalView for HPC documentation, in particular the User Guide, can provide useful information on how to use the commands to best advantage in debugging scenarios. This documentation is available in your TotalView for HPC distribution, or on the Rogue Wave web site.