About this Guide
Overview
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.
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.