Rogue Wave Software, Inc.
Voice: (303) 473-9118
support@roguewave.com
Panel Progress
Rogue Wave Software, Inc.
New in this Release
General TotalView Documentation
Totalview® Getting Started Guide
Getting Started with TotalView Products
About this Guide
The Basics
What is TotalView
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
TotalView 8.15.10 Platforms and System Requirements
User Guides
Reference Guides
Totalview® Reference Guide
About this Guide
About this Guide
Overview
TotalView Family Differences
TotalView for HPC Documentation
Conventions
Contacting Us
PART I CLI Commands
Chapter 1 CLI Command Summary
Chapter 2 CLI Commands
General CLI Commands
CLI Initialization and Termination Commands
Program Information Commands
Execution Control Commands
Action Points
Platform-Specific CLI Commands
Other Commands
alias
capture
dactions
dassign
dattach
dbarrier
dbreak
dcache
dcalltree
dcheckpoint
dcont
dcuda
ddelete
ddetach
ddisable
ddlopen
ddown
denable
dexamine
dflush
dfocus
dga
dgo
dgroups
dhalt
dheap
dhistory
dhold
dkill
dlappend
dlist
dload
dmstat
dnext
dnexti
dout
dprint
dptsets
drerun
drestart
drun
dsession
dset
dstatus
dstep
dunhold
dunset
duntil
dup
dwait
dwatch
dwhat
dwhere
dworker
exit
help
quit
spurs
stty
unalias
Chapter 3 CLI Namespace Commands
Accessor Functions
Helper Functions
actionpoint
dec2hex
dll
errorCodes
expr
focus_groups
focus_processes
focus_threads
group
hex2dec
process
read_symbols
respond
scope
source_process_startup
symbol
thread
type
type_transformation
Chapter 4 Batch Debugging Using tvscript
Overview
tvscript Command Syntax
tvscript Options
tvscript External Script Files
Logging Functions API
Process Functions API
Thread Functions API
Action Point API
Event API
Example tvscript Script File
Chapter 5 TotalView Variables
Overview
Top-Level (::) Namespace
TV:: Namespace
TV::MEMDEBUG:: Namespace
TV::GUI:: Namespace
Chapter 6 Creating Type Transformations
Overview
Why Type Transformations
Creating Structure and Class Transformations
Transforming Structures
build_struct_transform Function
Type Transformation Expressions
Using Type Transformations
C++View
Writing a Data Display Function
TV_ttf_type_ascii_string
TV_ttf_type_int
Templates
Precedence - Searching for TV_ttf_display_type
TV_ttf_add_row
TV_ttf_ec_ok
TV_ttf_ec_not_ active
TV_ttf_ec_invalid_characters
TV_ttf_ec_buffer_exhausted
Return values from TV_ttf_display_type
TV_ttf_format_ok
TV_ttf_format_ok_elide
TV_ttf_format_ failed
TV_ttf_format_ raw
TV_ttf_format_ never
Elision
Other Constraints
Safety
Memory Management
Multithreading
Tips and Tricks
Core Files
Using C++View with ReplayEngine
C
Fortran
Compiling and linking tv_data_display.c
C++View Example Files
Limitations
Licensing
PART II Running TotalView
Chapter 7 TotalView Command Syntax
Overview
Command-Line Syntax
Command-Line Options
Chapter 8 TotalView Debugger Server Command Syntax
Overview
The tvdsvr Command and Its Options
Description
Options
Replacement Characters
PART III Platforms and Operating Systems
Chapter 9 Platforms and Compilers
Overview
Compiling with Debugging Symbols
Apple Running Mac OS X
HP-UX for IA-64
IBM AIX on RS/6000 Systems
IBM Blue Gene
IBM Power Linux
Linux Running on an x86 Platform
Linux Running on an x86-64 Platform
Linux Running on an Itanium Platform
Sun Solaris
Using gnu_debuglink Files
Total View Command-Line Options and CLI State Variables
Searching for the gnu_debug_link File
Linking with the dbfork Library
Linking with HP-UX
dbfork on IBM AIX on RS/6000 Systems
Linking C++ Programs with dbfork
Linux or Mac OS X
SunOS 5 SPARC
Chapter 10 Operating Systems
Operating Systems
Supported Operating Systems
Troubleshooting Mac OS X Installations
Problem Description
For All OS X Versions
For OS X Versions 10.8 (Mountain Lion) or Later
Remotely Debugging without Console Access
Mounting the /proc File System
Mounting /proc with SunOS 5
Swap Space
Swap Space on HP HP-UX
Maximum Data Size
Swap Space on IBM AIX
Swap Space on Linux
Swap Space on SunOS 5
Shared Libraries
Changing Linkage Table Entries and LD_BIND_NOW
Using Shared Libraries on HP-UX
Debugging Your Program’s Dynamically Loaded Libraries
dlopen Options for Scalability
Filtering dlopen Events
Handling dlopen Events in Parallel
Known Limitations
Remapping Keys
Expression System
Expression System on IBM AIX-Power and Blue Gene/Q
Chapter 11 Architectures
Overview
AMD and Intel x86-64
x86-64 General Registers
x86-64 Floating-Point Registers
x86-64 FPCR Register
Using the x86-64 FPCR Register
x86-64 FPSR Register
x86-64 MXCSR Register
Power Architectures
Power General Registers
Blue Gene Power Registers
Blue Gene/Q QPX Floating-Point Registers
Power MSR Register
Power Floating-Point Registers
Power FPSCR Register
Using the Power FPSCR Register
Intel IA-64
Intel IA-64 General Registers
IA-64 Processor Status Register Fields (PSR)
Current Frame Marker Register Fields (CFM)
Register Stack Configuration Register Fields (RSC)
Previous Function State Register Fields (PFS)
Floating Point Registers
Floating Point Status Register Fields
Intel x86
Intel x86 General Registers
Intel x86 Floating-Point Registers
Intel x86 FPCR Register
Using the Intel x86 FPCR Register
Intel x86 FPSR Register
Intel x86 MXCSR Register
Sun SPARC
SPARC General Registers
SPARC PSR Register
SPARC Floating-Point Registers
SPARC FPSR Register
Using the SPARC FPSR Register
PART IV Appendices
Appendix A MPI Startup
Overview
Customizing Your Parallel Configuration
TotalView
Standalone MemoryScape
Example Parallel Configuration Definitions
Installation Guides
TotalView® Installation Guide
Chapter 1 Installing TotalView
Overview
Step 1: Unbundling Downloaded Files
Step 2: Running the Install Program
Step 3: Installing a Demo License
Setting the License File Variable
Step 4: Configuring Your Environment
Cray XT Installation
Installing
About the Install
Mac OS X Installations
Chapter 2 Installing or Changing a Regular License
Overview
Is My License Valid for this Release?
Planning for a Regular License
Choosing a License Server
Finding a License Server Host ID
Creating a FlexNet User Account
Installing your Permanent License
Accessing a License Server
Starting the License Manager Manually
Stopping the License Manager
Testing the License Manager
Starting the License Manager When the System Boots
Installing FlexNet Standalone
Starting the Install Program
More FlexNet Information
Chapter 3 Installing License Keys
Overview
Step 1: Locating the FlexNet License Server Directory
Step 2: Deleting Older License Keys
Step 3: Adding New License Keys
Adding a New license.dat File
Revising Your license.dat File
Step 4: Starting and Stopping the License Server
Step 5: Configuring TotalView to Use the License Server
Reporting Problems with License Installation
Chapter 4 Installing TotalView Individual
Supported Platforms
Download and Install
Chapter 5 Uninstalling TotalView
The Three-Step Removal Process
MemoryScape™ Installation Guide
Chapter 1 Installing MemoryScape
Step 1: Unbundling Downloaded Files
Step 2: Running the Install Program
Step 3: Installing a Demo License
Setting the License File Variable
Step 4: Configuring Your Environment
Mac OS X Installations
Chapter 2 Installing or Changing a Regular License
Planning for a Regular License
Choosing a License Server
Finding a License Server Host ID
Creating a FlexNet User Account
Installing your Permanent License
Accessing a License Server
Starting the License Manager Manually
Stopping the License Manager
Testing the License Manager
Starting the License Manager When the System Boots
Installing FlexNet Standalone
Starting the Install Program
More FlexNet Information
Chapter 3 Installing License Keys
Step 1: Locating the FlexNet License Server Directory
Step 2: Deleting Older License Keys
Step 3: Adding New License Keys
Step 4: Starting and Stopping the License Server
Step 5: Configuring MemoryScape to Use the License Server
Reporting Problems with License Installation
Chapter 4 Uninstalling MemoryScape
The Three-Step Removal Process
In-Product Help
Rogue Wave Software, Inc.
Index
Rogue Wave Software, Inc.
Totalview® Reference Guide
Example Parallel Configuration Definitions
TypeTransformations
Totalview® Getting Started Guide
TotalView® Installation Guide
Chapter 4 Uninstalling MemoryScape