Totalview® for HPC User Guide : About This Guide
About This Guide
Content Organization
This guide describes how to use the TotalView® for HPC debugger, a source- and machine-level debugger for multi-process, multi-threaded programs. It is assumed that you are familiar with programming languages, a UNIX or Linux operating system, and the processor architecture of the system on which you are running TotalView and your program.
This user guide combines information for running the TotalView debugger either from within a Graphic User Interface (GUI), or the Command Line Interface (CLI), run within an xterm-like window for typing commands.
The information here emphasizes the GUI interface, as it is easier to use. Understanding the GUI will also help you understand the CLI.
Although TotalView doesn’t change much from platform to platform, differences between platforms are mentioned.
The information in this guide is organized into these parts:
• Part I, “Introduction to Debugging with TotalView” contains an overview of TotalView features and an introduction to debugging with TotalView.
• Part II, “Debugging Tools and Tasks” describes the function and use of TotalView’s primary set of debugging tools, such as stepping (Chapter 7), setting breakpoints (Chapter 8) and examining data including arrays (Chapter 9 and Chapter 10).
This part also includes detail on TotalView’s process/thread model (Chapter 13 and working with multi-process, multi-threaded programs (Chapter 14).
• Part III, “Using the CLI” discusses the basics of using the Command Line Interface (CLI) for debugging. CLI commands are not documented in this book but in the TotalView for HPC Reference Guide.
• Part IV, “Advanced Tools and Customization” provides additional information required for setting up various MPI and other parallel programming environments, including high performance computing environments such as MPICH, OpenMP, UPC, and CAF. Chapter 18 discusses how to get the TotalView Debugger Server (tvdsvr) running and how to reconfigure the way that TotalView launches the tvdsvr. Chapter 21 builds on previous process/thread discussions to provide more detailed configuration information and ways to work in multi-process, multi-threaded environments.
In most cases, TotalView defaults work fine and you won’t need much of this information.
• Part V, “Using the CUDA Debugger” describes the CUDA debugger, including a sample application.