Totalview® Reference Guide
About this Guide
About this Guide
Overview
TotalView Family Differences
Conventions
TotalView Documentation
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
dstepi
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
Overview
Customizing Your Parallel Configuration
TotalView
Standalone MemoryScape
Example Parallel Configuration Definitions
Totalview® Reference Guide
Example Parallel Configuration Definitions