TotalView

Table of Contents

  1. Part 1: The Very Basics
    1. Overview
    2. Starting TotalView
      1. Environment Setup
      2. Compiling Your Program
      3. Starting TotalView
    3. TotalView's Basic Look and Feel
      1. Primary Windows
      2. Dialog Boxes
      3. Mouse Usage
      4. Menus
      5. Accelerator Keys
      6. Scrolling, Resizing and Memorizing
      7. Process and Thread State Codes
      8. X Resources
    4. TotalView's Basic Functions
      1. Viewing Source Code
      2. Setting a Breakpoint
      3. Controlling Execution
      4. Diving
      5. Viewing and Modifying Data
      6. Text Editing and Searching
      7. Saving Window Contents
      8. Getting Help
      9. Exiting TotalView

  2. Part 2: Common Functions
    1. Loading Executables
    2. Attaching / Detaching Processes
    3. Viewing a Core File
    4. Expression Evaluation and Code Fragments
    5. More on Action Points
    6. Setting Executable Command Arguments
    7. Setting Source Code Search Paths
    8. Setting stdin, stdout, and stderr
    9. Signal Handling
    10. Displaying Your Program's Call Tree
    11. Debugging Memory Problems
    12. Setting Preferences
    13. Visualizing Array Data
    14. Command Line Interpreter (CLI)

  3. Part 3: Debugging Parallel Programs
    1. Process/Thread Groups
    2. Debugging Threaded Codes
      1. Overview
      2. Finding Thread Information
      3. Selecting a Thread
      4. Execution Control for Threaded Programs
      5. Viewing and Modifying Thread Data
    3. Debugging OpenMP Codes
      1. Overview
      2. Debugging OpenMP Programs
    4. Debugging MPI Codes
      1. Overview
      2. Starting an MPI Debug Session
      3. Selecting an MPI Process
      4. Controlling MPI Process Execution
      5. Viewing and Modifying Multi-process Data
      6. Displaying Message Queue State
    5. Debugging Hybrid Codes
      1. Overview
      2. Debugging Hybrid Programs
    6. Batch System Debugging
    7. Topics Not Covered

  4. References and More Information


TotalView Part 1:
The Very Basics



Overview


What is TotalView?

Key Features of TotalView:

Supported Platforms and Languages

How to Obtain TotalView:

Starting TotalView

Environment Setup

LC takes care of most of this for users.

Path Variable:

License Manager File:

Authorization:

Xwindows:


Compiling Your Program

-g:

Beyond -g:


Starting TotalView

A Variety of Ways:

Some Examples:

More Information:



TotalView's Basic Look and Feel

Primary Windows

Root Window:

Process Window:

Variable Window:



TotalView's Basic Look and Feel

Dialog Boxes



TotalView's Basic Look and Feel

Mouse Usage



TotalView's Basic Look and Feel

Menus

Two Types of Menus:

TotalView's Basic Look and Feel

Accelerator Keys

Short Cut:

Examples:



TotalView's Basic Look and Feel

Scrolling, Resizing and Memorizing

Conventional Scrolling Behavior:

Resizing Windows and Panes:

Memorizing Windows:

  • The "Window" menu (if present) will allow you to save the position and size of that window, or all windows.

  • A convenience feature for those who like to have their TotalView sessions customized.

  • Resized panes inside a window are not memorized.
’Memorize


TotalView's Basic Look and Feel

Process and Thread State Codes



TotalView's Basic Look and Feel

X Resources



TotalView's Basic Functions

Viewing Source Code

Source, Assembler or Both:

Displaying Function / File Source Code:



TotalView's Basic Functions

Setting a Breakpoint

What Is a Breakpoint?

Several Ways to Set / Unset a Breakpoint:

  • Method 1: The easiest way to set a breakpoint is to simply click on a source code line number with the left mouse button. A red STOP icon will then appear on the source line number, as shown at right.

  • Method 2: Right mouse click anywhere on the desired source line until the pop-up menu appears (right). Then select Set Breakpoint.

  • Method 3: First, click on a source line to select it (make sure it's highlighted). Then use:

    Process Window  >  Action Point Menu  >  Set Breakpoint 

  • Method 4: For any arbitrary line number, use the path below. A dialog box will then open to prompt you for the line number.

    Process Window  >  Action Point Menu  >  At Location 

  • To unset the breakpoint, simply click on the red STOP icon or select "delete" from the pop-up menu or Action Point menu.
Breakpoint icon on source line number

Pop-up menu

Viewing Breakpoints:

Breakpoint Options:



TotalView's Basic Functions

Controlling Execution

Execution Control Commands:

Group, Process, Thread Command Scopes:



TotalView's Basic Functions

Diving

Example:

Nested Dives and Undiving:



TotalView's Basic Functions

Viewing and Modifying Data

Viewing Data:

Examples:

Modifying Variable Data:

Arrays:

Changing Variable Display Format:

Changing Variable Data Types:



TotalView's Basic Functions

Text Editing and Searching

Text Editing:
  • TotalView provides a basic field editor for use within certain debugger fields and windows. Text which can be edited will be highlighted and display a field editor cursor.

  • Cutting and pasting can be accomplished by using the middle mouse button or by selecting Cut, Copy, or Paste from any window's Edit pull-down menu.

Text Searching:

  • Most TotalView windows will permit you to search for text strings. Simply select Find from any window's Edit pull-down menu.

  • A dialog box will appear for you to enter the string to search for, plus any search options, as shown at right.

  • Select Find Again from the same Edit menu to repeat a search.
Text editing example

Find String Dialog Box



TotalView's Basic Functions

Saving Window Contents



TotalView's Basic Functions

Getting Help



TotalView's Basic Functions

Exiting TotalView




This concludes TotalView Part 1

Where would you like to go now?