Rogue Wave Software, Inc.
Voice: (303) 473-9118
support@roguewave.com
Panel Progress
Rogue Wave Software, Inc.
New in this Release
New in TotalView® for HPC 2019
TotalView® for HPC 2019 Supported Platforms
Versions
Support Notes
Platform Support
TotalView® for HPC Getting Started Guide
Getting Started with TotalView Products
About this Guide
The Basics
What is TotalView® for HPC
Starting TotalView and Creating a Debugging Session
Loading Programs into TotalView for Debugging
Managing Debugging Sessions
Getting Around TotalView
TotalView Commands
The Root Window
The Process Window
Variable Window and Array Viewer
Accessing TotalView Remotely
Debugging on a Remote Host
Setting Breakpoints and Stepping through a Program
Action Points (breakpoints)
Stepping Through a Program
Examining and Editing Data
Diving and Viewing Data
Editing Data
Evaluating Expressions
Working with Multi-Processes and Multi-Threads
Starting a Parallel Debugging Job
Working with and Viewing Processes and Threads
Debugging Using the Command Line Interface (CLI)
Debugging CUDA Programs
Memory Debugging
Viewing Memory Event Information
Finding Memory Leaks
Detecting Memory Corruption
Analyzing Memory
Finding Dangling Pointers
Setting and Using Baselines
Reverse Debugging with ReplayEngine
User Guides
Reference Guide
Installation Guide
In-Product Help
TotalView Online Help
Chapter 1 Root Window
Root Window Pages
Viewing Remote Processes
File Menu Commands
File > New Debugging Session
My Last Session
File > Debug New Program
Program Details
Program Arguments
Adding a Remote Host
Debug Options
Setting Environment Variables and Altering Standard I/O
Environment Variables
Standard I/O
Adding Notes to a Session
File > Debug New Parallel Program
Program Details, Parallel Program Session
Preview Launch
File > Attach to a Running Program
Searching for Processes
Attach Options
File > Debug Core or Replay Recording File
File > Manage Sessions
Editing or Starting New Sessions in a Sessions Window
File > Search Path
File > Preferences
Options Page
Action Points Page
Launch Strings Page
Bulk Launch Page
Dynamic Libraries Page
Parallel Page
Display Page
Formatting Page
Pointer Dive Page
ReplayEngine Page
File > Close
File > Exit
Edit Menu Commands
Edit > Undo
Edit > Select All
Edit > Cut
Edit > Copy
Edit > Paste
Edit > Delete
Edit > Find
Edit > Find Again
View Menu Commands
View > Dive
View > Dive in New Window
View > Expand All
View > Collapse All
View > Jump to Process/Thread
View > Show MPI Rank
View > Nested Attributes
View > Show Configure Panel
Tools Menu Commands
Tools > Open MemoryScape
Tools > Event Log
Tools > Warnings
Tools > Command Line
Chapter 2 Process Window
Process Window Panes
Stack Trace Pane
Stack Frame Pane
Source Pane
Set Breakpoints
Dive on Functions or Variables
Threads Tab
Processes/Ranks Tab
Action Points Tab
File Menu Commands
File > New Debugging Session
File > Debug New Program
File > Debug New Parallel Program
File > Attach to a Running Program
File > Debug Core or Replay Recording File
File > Manage Sessions
File > Save Recording File
File > Search Path
File > Signals
File > Preferences
File > Open Source
File > Edit Source
File > Save Pane
File > Rescan Libraries
File > Close Relatives
File > Close
File > Exit
Edit Menu Commands
Edit > Undo
Edit > Cut
Edit > Copy
Edit > Paste
Edit > Delete
Edit > Find
Edit > Find Again
View Menu Commands
View > Dive
View > Dive in New Window
View > Undive
View > Redive
View > Reset
View > Lookup Function
View > Lookup Variable
View > Next Process
View > Previous Process
View > Source As > Source
View > Source As > Assembler
View > Source As > Both
View > Assembler > Symbolically
View > Assembler > By Address
View > Display Managers
Group Menu Commands
Group > Go
Group > Halt
Group > Next
Group > Step
Group > Out
Group > Run To
Group > Next Instruction
Group > Step Instruction
Group > Hold
Group > Release
Group > Attach Subset
Group > Custom Groups
Group > Detach
Group > Restart
Group > Kill
Process Menu Commands
Process > Go
Process > Halt
Process > Next
Process > Step
Process > Out
Process > Run To
Process > Next Instruction
Process > Step Instruction
Process > Hold
Process > Hold Threads
Process > Release Threads
Process > Create
Process > Detach
Process > Startup Parameters
Debugging Options Page
Arguments Page
Standard I/O Page
Parallel Page
Thread Menu Commands
Thread > Go
Thread > Halt
Thread > Next
Thread > Step
Thread > Out
Thread > Run To
Thread > Next Instruction
Thread > Step Instruction
Thread > Set PC
Thread > Hold
Thread > Continuation Signal
Action Point Menu
Action Point > Set Breakpoint
Action Point > Set Barrier
Action Point > At Location
Action Point > Create Watchpoint
Action Point > Enable
Action Point > Disable
Action Point > Delete
Action Point > Properties
General Controls
Breakpoint
Barrier
Evaluate
Action Point > Suppress All
Action Point > Delete All
Action Point > Load All
Action Point > Save All
Action Point > Save As
Debug Menu Commands
Debug > Enable ReplayEngine
Debug > Previous
Debug > Unstep
Debug > Caller
Debug > Back To
Debug > Go Back
Debug > Live
Debug > Enable Memory Debugging
Debug > Stop on Memory Errors
Debug > Open MemoryScape
Debug > Heap Baseline >Set Heap Baseline (in Process)
Debug > Heap Baseline> Set Heap Baseline (in Group)
Debug > Heap Baseline > Heap Change Summary
Debug > Memory Block Properties
Debug > Memory Event Details
Tools Menu Commands
Tools > Evaluate
Tools > Expression List
Tools > Program Browser
Tools > Fortran Modules
Tools > Call Graph
Tools > Parallel Backtrace View
Tools > Debugger Loaded Libraries
Tools > Event Log
Tools > Warnings
Tools > Thread Objects
Tools > Message Queue
Tools > Message Queue Graph
Options Dialog Box
Tools > Create Checkpoint
Tools > Restart Checkpoint
Tools > Global Arrays
Tools > Command Line
Window Menu Commands
Window > Update
Window > Update All
Window > Duplicate
Window > Memorize
Window > Memorize all
Window > Root
Chapter 3 Variable Window
Variable Window Overview
File Menu Commands
File > Save Pane
File > Close Similar
File > Close
File > Exit
Edit Menu Commands
Edit > Undo
Edit > Reset Defaults
Edit > Cut
Edit > Copy
Edit > Paste
Edit > Delete
Edit > Find
Edit > Find Again
View Menu Commands
View > Dive
View > Dive in New Window
View > Dive In All
View > Expand All
View > Collapse All
View > Undive
View > Undive All
View > Redive
View > Redive All
View > Freeze
View > Lock Address
View > Show Across > None
View > Show Across > Process
View > Show Across > Thread
View > Compilation Scope > Fixed
View > Compilation Scope > Floating
View > Loader Symbols
View > Padding
View > Break At Newlines
View > Examine Format > None
View > Examine Format > Structured
View > Examine Format > Raw
View > Block Status
Tools Menu Commands
Tools > Create Watchpoint
Platform Restrictions
Watchpoint Commands
Unconditional Watchpoints
Conditional Watchpoints
Tools > Add to Expression List
Tools > Add to Block Properties
Tools > Visualize
Tools > Visualize Distribution
Tools > Statistics
Tools > Attach Subset (Array of Ranks)
Tools > Array Viewer
Expression Field
Type Field
Slice Definition
Update View Button
Data Display
Window Menu Commands
Window > Update
Window > Update All
Window > Duplicate
Window > Memorize
Window > Memorize all
Window > Root
Chapter 4 Visualizer Window
Dataset Window
File Menu Commands
View Menu Commands
Options Menu Command
View Window
File Menu Commands
Chapter 5 Fortran Modules Window
File Menu Commands
File > Close Similar
File > Close
Edit Menu Commands
Edit > Undo
Edit > Cut
Edit > Copy
Edit > Paste
Edit > Delete
Edit > Find
Edit > Find Again
View Menu Commands
View > Dive
View > Dive in New Window
Window Menu Commands
Window > Update
Window > Update All
Window > Memorize
Window > Memorize all
Window > Root
Chapter 6 Program Browser Window
File Menu Commands
File > Close Similar
File > Close
File > Exit
Edit Menu Commands
Edit > Undo
Edit > Cut
Edit > Copy
Edit > Paste
Edit > Delete
Edit > Find
Edit > Find Again
View Menu Commands
View > Dive
View > Dive in New Window
Window Menu Commands
Window > Update
Window > Update All
Window > Memorize
Window > Memorize all
Window > Root
Chapter 7 Message Queue Window
Message Queue Window Overview
Message Operations
File Menu Commands
File > Close Similar
File > Close
File > Exit
Edit Menu Commands
Edit > Undo
Edit > Cut
Edit > Copy
Edit > Paste
Edit > Delete
Edit > Find
Edit > Find Again
View Menu Commands
View > Dive
View > Dive in New Window
Window Menu Commands
Window > Update
Window > Update All
Window > Memorize
Window > Memorize all
Window > Root
Chapter 8 Thread Objects Window
IBM AIX
Mutexes Page
Condition Variables Page
R/W Locks Page
Data Keys Page
File Menu Commands
File > Close Similar
File > Close
File > Exit
Edit Menu Commands
Edit > Undo
Edit > Cut
Edit > Copy
Edit > Paste
Edit > Delete
Edit > Find
Edit > Find Again
View Menu Commands
View > Dive ...
View > Dive ... in New Window
Window Menu Commands
Window > Update
Window > Update All
Window > Memorize
Window > Memorize all
Window > Root
Chapter 9 Expression List Window
Expression List Window Overview
Entering Variables and Expression into the Expression List Window
Opening and Closing the Expression List Window
What Can You Enter in the Expression Column
Manipulating the Expression List Window
Multiprocess/Multithreaded Behavior
File Menu Commands
File > Preferences
File > Save Pane
File > Close Similar
File > Close
File > Exit
Edit Menu Commands
Edit > Undo
Edit > Reset Default
Edit > Cut
Edit > Copy
Edit > Paste
Edit > Delete
Edit > Delete Expression
Edit > Delete All Expressions
Edit > Duplicate Expression
Edit > Find
Edit > Find Again
View Menu Commands
View > Dive
View > Freeze
Window Menu Commands
Window > Update
Window > Update All
Window > Duplicate
Window > Memorize
Window > Memorize all
Window > Root
Chapter 10 Other Topics
Other Dialog Boxes
Ambiguous Line Dialog Box
Ambiguous Function Dialog Box
Process Load Libraries
Memory Debugging in Parallel Environments
MPICH
IBM PE
SGI MPI
RMS MPI
Linking Your Application With the Agent
Using env to Insert the Agent
Installing tvheap_mr.a on AIX
LIBPATH and Linking
Setting Search Paths Using TotalView Variables
Search Path Variables That You Can Set
TOTALVIEW_SRC
PATH
EXECUTABLE_PATH
Search Path Variables That TotalView Sets
COMPILATION_DIRECTORY_COMPONENT
COMPILATION_WORKING_DIRECTORY
COMPILATION_DIRECTORY
EXECUTABLE_DIRECTORY_COMPONENT
EXECUTABLE_WORKING_DIRECTORY
EXECUTABLE_DIRECTORY
TotalView Built-in Functions
Using the $tree() Function
Using the File > Search Path Dialog Box
Debugging Memory Problems with MemoryScape
Add Core File
Add Memory Debugging File
Add New Program
Add New Program (Parallel)
Add Programs to Your MemoryScape Session
Attach to a Running Program
Block Properties
Configure Process Signal Actions
Corrupted Memory Report
Enter Block Address
Event Reports
Export Memory Data
File > Preferences (Memory Debugging)
File > Preferences (Remote Debugging)
File > Search Path
Filters: Add & Edit
Create Heap Status Reports
Create Leak Detection Report
Create Reports
Generate a Memory Usage Report
Generating ...
Heap Status Graphical Report
Heap Status Backtrace Report
Heap Status Source Report
Leak Detection Backtrace Report
Leak Detection Source Report
Manage Processes and Files
Memory Comparison Report
Memory Debugging Data Filters
Memory Debugging Options: Advanced
Memory Debugging Options: Basic
Memory Debugging Session
Memory Event Notification
Memory Usage Chart Report
Memory Usage Library Report
Memory Usage Process Report
Process Event: About to Exit
Process Event by Event
Process Event by Process
Process Properties
Program Created
Red Zones: Customizing
Red Zones: Restricting
Save Report
Select Processes To Use For The Report
Select Processes
Window > Duplicate
tvdsvr Command and Options
tvdsvr Replacement Characters
Rogue Wave Software, Inc.
Index
Rogue Wave Software, Inc.
New in TotalView® for HPC 2019
Reverse Debugging with ReplayEngine
TotalView Online Help
tvdsvr Replacement Characters
RootWindow
SessionStartupDialog
SessionProgramStep
NewProgramArguments
AddHostDialog
SessionDebugOptionsStep
SessionEnvironmentStep
SessionParallelStep
SessionParallelDetailsStep
SessionParallelPreviewStep
SessionAttachStep
SessionCoreFileStep
SessionManagerDialog
RootFileSearchPathDialogBox
RootFilePreferencesDialogBox
PreferencesOptionsPage
PreferencesActionPointsPage
PreferencesLaunchStringsPage
PreferencesBulkLaunchPage
PreferencesDynamicLibrariesPage
PreferencesParallelPage
PreferencesFontsPage
PreferencesFormattingPage
PreferencesPointerDivePage
PreferencesReplayEnginePage
RootFileCloseDialogBox
RootEditFindDialogBox
EventLog
ProcessWindowStackTracePane
ProcessWindowStackFramePane
ProcessWindowSourcePane
ProcessWindowThreadListPane
ProcessWindowRanksTab
ProcessWindowActionPointsPane
ProcessFileSearchPathDialogBox
ProcessFileSignalsDialogBox
OpenSource
ProcessEditFindDialogBox
ProcessViewLookupFunctionDialogBox
ProcessViewLookupVariableDialogBox
AttachDialogBox
GroupCustomGroups
EditGroup
ProcessProcessStartupDialogBox
DebuggingOptions
StartupArgumentsPage
StandardIOPage
StartupParallelPage
ProcessThreadContinuationSignalDialogBox
ProcessActionPointAtLocationDialogBox
ProcessActionPointPropertiesDialogBox
Action_Point_Addresses_Dialog
ActionPointLoadAll
ActionPointSaveAs
HeapChangeSummary
ToolsMemoryBlockProperties
HeapErrorDetails
ProcessToolsEvaluateDialogBox
ProcessToolsFortranModulesCommand
ProcessToolsCallTreeDialogBox
ParallelBacktraceView
DynamicLibraries
ProcessEventLog
ProcessToolsMessageQueueCommand
ProcessToolsMessageQueueGraphDialogBox
ProcessToolsCheckpointDialogBox
ProcessToolsCheckpointRestartDialogBox
GlobalArray
VariableWindow
VariableToolsWatchpointDialogBox
VariableToolsStatisticsCommand
ArrayViewerWindow
VisualizerFileOptionsCommand
FortranModulesWindow
GlobalsWindow
MessageQueueWindow
ThreadObjectsWindow
VariableList
VariableListFileSavePane
VariableListFileExit
AmbiguousLineDialogBox
AmbiguousFunctionDialogBox
ProcessStopQuestion
MemoryDebuggingInParallelEnvironments
AttachingToPrograms
AddCoreFile
AddMemoryDebuggingfile
AddNewProgram
AddParallelProgram
AddPrograms
AttachtoProgram
BlockProperties
ConfigureSignal
CorruptedMemory
EnterBlockAddress
ProcessEventReport
ExportMemoryData
FilePreferences
RemoteDebugging
FileSearchPath
AddEditFilters
GenerateHeapReports
GenerateLeakReports
GenerateReports
GenerateMemoryUsageReports
Generating
HeapGraphical
HeapBacktace
HeapSource
LeakDetectionBacktrace
LeakDetectionSource
ManageProcessesFiles
MemoryComparison
DataFilters
MemoryOptionsAdvanced
MemoryOptionsBasic
MemoryDebuggingSession
MemoryEventNotification
MemoryUsageChartView
MemoryUsageLibraryView
MemoryUsageProcessView
ProcessEventExit
ProcessEventByEvent
ProcessEvent
ProcessProperties
ProgramCreated
CustomizingRedZones
RestrictingRedZones
SaveReport
SelectProcessForReport
ObtainingComparison
WindowDuplicate
RemoteDebuggingTvdsvr