Sun Studio 12: Debugging a Program With dbx

Book Information
Index
- Numbers and Symbols
- A
- B
- C
- D
- E
- F
- G
- H
- I
- J
- K
- L
- M
- N
- O
- P
- Q
- R
- S
- T
- U
- V
- W
- X
Preface
Chapter 1 Getting Started With dbx
- Compiling Your Code for Debugging
- Starting dbx and Loading Your Program
- Running Your Program in dbx
- Debugging Your Program With dbx
- Quitting dbx
- Accessing dbx Online Help
Chapter 2 Starting dbx
- Starting a Debugging Session
- Debugging a Core File
- Using the Process ID
- The dbx Startup Sequence
- Setting Startup Properties
- Compiling a Program for Debugging
  - Compiling with the -g Option
  - Using a Separate Debug File
    - Creating a Separate Debug File
- Debugging Optimized Code
- Quitting Debugging
- Saving and Restoring a Debugging Run
Chapter 3 Customizing dbx
- Using the dbx Initialization File
  - Creating a .dbxrc File
  - Initialization File Sample
- Setting dbx Environment Variables
- The dbx Environment Variables and the Korn Shell
Chapter 4 Viewing and Navigating To Code
- Navigating To Code
- Types of Program Locations
- Program Scope
  - Variables That Reflect the Current Scope
  - Visiting Scope
    - Components of the Visiting Scope
    - Changing the Visiting Scope
- Qualifying Symbols With Scope Resolution Operators
- Locating Symbols
- Viewing Variables, Members, Types, and Classes
  - Looking Up Definitions of Variables, Members, and Functions
  - Looking Up Definitions of Types and Classes
- Debugging Information in Object Files and Executables
- Finding Source and Object Files
Chapter 5 Controlling Program Execution
- Running a Program
- Attaching dbx to a Running Process
- Detaching dbx From a Process
- Stepping Through a Program
- Using Ctrl+C to Stop a Process
Chapter 6 Setting Breakpoints and Traces
- Setting Breakpoints
- Setting Filters on Breakpoints
  - Using the Return Value of a Function Call as a Filter
    - Using Variable Scope as a Filter
    - Using a Filter With a Conditional Event
- Tracing Execution
- Setting a when Breakpoint at a Line
- Setting a Breakpoint in a Shared Library
- Listing and Clearing Breakpoints
  - Listing Breakpoints and Traces
  - Deleting Specific Breakpoints Using Handler ID Numbers
- Enabling and Disabling Breakpoints
- Efficiency Considerations
Chapter 7 Using the Call Stack
- Finding Your Place on the Stack
- Walking the Stack and Returning Home
- Moving Up and Down the Stack
- Popping the Call Stack
- Hiding Stack Frames
- Displaying and Reading a Stack Trace
Chapter 8 Evaluating and Displaying Data
- Evaluating Variables and Expressions
- Assigning a Value to a Variable
- Evaluating Arrays
Chapter 9 Using Runtime Checking
- Capabilities of Runtime Checking
  - When to Use Runtime Checking
  - Runtime Checking Requirements
- Using Runtime Checking
- Using Access Checking
  - Understanding the Memory Access Error Report
  - Memory Access Errors
- Using Memory Leak Checking
- Using Memory Use Checking
- Suppressing Errors
- Using Runtime Checking on a Child Process
- Using Runtime Checking on an Attached Process
- Using Fix and Continue With Runtime Checking
- Runtime Checking Application Programming Interface
- Using Runtime Checking in Batch Mode
- Troubleshooting Tips
- Runtime Checking Limitations
- Runtime Checking Errors
  - Access Errors
  - Memory Leak Errors
Chapter 10 Fixing and Continuing
- Using Fix and Continue
  - How Fix and Continue Operates
  - Modifying Source Using Fix and Continue
- Fixing Your Program
  - To Fix Your File
  - Continuing After Fixing
- Changing Variables After Fixing
- Modifying a Header File
- Fixing C++ Template Definitions
Chapter 11 Debugging Multithreaded Applications
- Understanding Multithreaded Debugging
- Understanding Thread Creation Activity
- Understanding LWP Information
Chapter 12 Debugging Child Processes
- Attaching to Child Processes
- Following the exec Function
- Following the fork Function
- Interacting With Events
Chapter 13 Debugging OpenMP Programs
- How Compilers Transform OpenMP Code
- dbx Functionality Available for OpenMP Code
- Using Stack Traces With OpenMP Code
- Using the dump Command on OpenMP Code
- Execution Sequence of OpenMP Code
Chapter 14 Working With Signals
- Understanding Signal Events
- Catching Signals
  - Changing the Default Signal Lists
  - Trapping the FPE Signal (Solaris Platforms Only)
    - Determining Where the Exception Occurred
    - Determining the Cause of the Exception
- Sending a Signal to a Program
- Automatically Handling Signals
Chapter 15 Debugging C++ With dbx
- Using dbx With C++
- Exception Handling in dbx
  - Commands for Handling Exceptions
  - Examples of Exception Handling
- Debugging With C++ Templates
  - Template Example
  - Commands for C++ Templates
Chapter 16 Debugging Fortran Using dbx
- Debugging Fortran
- Debugging Segmentation Faults
  - Using dbx to Locate Problems
- Locating Exceptions
- Tracing Calls
- Working With Arrays
  - Fortran 95 Allocatable Arrays
- Showing Intrinsic Functions
- Showing Complex Expressions
- Showing Interval Expressions
- Showing Logical Operators
- Viewing Fortran 95 Derived Types
- Pointer to Fortran 95 Derived Type
Chapter 17 Debugging a Java Application With dbx
- Using dbx With Java Code
  - Capabilities of dbx With Java Code
  - Limitations of dbx With Java Code
- Environment Variables for Java Debugging
- Starting to Debug a Java Application
- Customizing Startup of the JVM Software
- dbx Modes for Debugging Java Code
  - Switching from Java or JNI Mode to Native Mode
  - Switching Modes When You Interrupt Execution
- Using dbx Commands in Java Mode
Chapter 18 Debugging at the Machine-Instruction Level
- Examining the Contents of Memory
- Stepping and Tracing at Machine-Instruction Level
  - Single Stepping at the Machine-Instruction Level
  - Tracing at the Machine-Instruction Level
- Setting Breakpoints at the Machine-Instruction Level
  - Setting a Breakpoint at an Address
- Using the regs Command
Chapter 19 Using dbx With the Korn Shell
- ksh-88 Features Not Implemented
- Extensions to ksh-88
- Renamed Commands
- Rebinding of Editing Functions
Chapter 20 Debugging Shared Libraries
- Dynamic Linker
- Fix and Continue
- Setting Breakpoints in Shared Libraries
- Setting a Breakpoint in an Explicitly Loaded Library
Appendix A Modifying a Program State
- Impacts of Running a Program Under dbx
- Commands That Alter the State of the Program
Appendix B Event Management
- Event Handlers
- Event Safety
- Creating Event Handlers
- Manipulating Event Handlers
- Using Event Counters
- Setting Event Specifications
- Event Specification Modifiers
- Parsing and Ambiguity
- Using Predefined Variables
  - Variables Valid for when Command
    - $handlerid
    - $booting
  - Variables Valid for Specific Events
- Setting Event Handler Examples
Appendix C Command Reference
- assign Command
  - Native Mode Syntax
  - Java Mode Syntax
- attach Command
  - Syntax
    - To Attach to a Running Java Process
- bsearch Command
  - Syntax
- call Command
  - Native Mode Syntax
  - Java Mode Syntax
- cancel Command
  - Syntax
- catch Command
  - Syntax
- check Command
  - Syntax
- clear Command
  - Syntax
- collector Command
  - Syntax
  - collector archive Command
    - Syntax
  - collector dbxsample Command
    - Syntax
  - collector disable Command
    - Syntax
  - collector enable Command
    - Syntax
  - collector heaptrace Command
    - Syntax
  - collector hw_profile Command
    - Syntax
  - collector limit Command
    - Syntax
  - collector mpitrace Command
    - Syntax
  - collector pause Command
    - Syntax
  - collector profile Command
    - Syntax
  - collector resume Command
    - Syntax
  - collector sample Command
    - Syntax
  - collector show Command
    - Syntax
  - collector status Command
    - Syntax
  - collector store Command
    - Syntax
  - collector synctrace Command
    - Syntax
  - collector tha Command
    - Syntax
  - collector version Command
    - Syntax
- cont Command
  - Syntax
- dalias Command
  - Syntax
- dbx Command
  - Native Mode Syntax
  - Java Mode Syntax
  - Options
- dbxenv Command
  - Syntax
- debug Command
  - Native Mode Syntax
  - Java Mode Syntax
  - Options
- delete Command
  - Syntax
- detach Command
  - Native Mode Syntax
  - Java Mode Syntax
- dis Command
  - Syntax
  - Options
- display Command
  - Native Mode Syntax
  - Java Mode Syntax
- down Command
  - Syntax
- dump Command
  - Syntax
- edit Command
  - Syntax
- examine Command
  - Syntax
- exception Command
  - Syntax
- exists Command
  - Syntax
- file Command
  - Syntax
- files Command
  - Native Mode Syntax
  - Java Mode Syntax
- fix Command
  - Syntax
- fixed Command
  - Syntax
- fortran_modules Command
  - Syntax
- frame Command
  - Syntax
- func Command
  - Native Mode Syntax
  - Java Mode Syntax
- funcs Command
  - Syntax
- gdb Command
  - Syntax
- handler Command
  - Syntax
- hide Command
  - Syntax
- ignore Command
  - Syntax
- import Command
  - Syntax
- intercept Command
  - Syntax
- java Command
  - Syntax
- jclasses Command
  - Syntax
- joff Command
  - Syntax
- jon Command
  - Syntax
- jpkgs Command
  - Syntax
- kill Command
  - Syntax
- language Command
  - Syntax
- line Command
  - Syntax
    - Examples
- list Command
  - Syntax
    - Options
    - Examples
- listi Command
- loadobject Command
  - Syntax
  - loadobject -dumpelf Command
    - Syntax
  - loadobject -exclude Command
    - Syntax
  - loadobject -hide Command
    - Syntax
  - loadobject -list Command
    - Syntax
  - loadobject -load Command
    - Syntax
  - loadobject -unload Command
    - Syntax
  - loadobject -use Command
    - Syntax
- lwp Command
  - Syntax
- lwps Command
  - Syntax
- mmapfile Command
  - Syntax
- module Command
  - Syntax
    - Example
- modules Command
  - Syntax
- native Command
  - Syntax
- next Command
  - Native Mode Syntax
  - Java Mode Syntax
- nexti Command
  - Syntax
- pathmap Command
  - Syntax
    - Examples
- pop Command
  - Syntax
- print Command
  - Native Mode Syntax
  - Java Mode Syntax
- proc Command
  - Syntax
- prog Command
  - Syntax
- quit Command
  - Syntax
- regs Command
  - Syntax
    - Example (SPARC platform)
- replay Command
  - Syntax
- rerun Command
  - Syntax
- restore Command
  - Syntax
- rprint Command
  - Syntax
- rtc showmap Command
  - Syntax
- rtc skippatch Command
  - Syntax
- run Command
  - Native Mode Syntax
  - Java Mode Syntax
- runargs Command
  - Syntax
- save Command
  - Syntax
- scopes Command
  - Syntax
- search Command
  - Syntax
- showblock Command
  - Syntax
- showleaks Command
  - Syntax
- showmemuse Command
  - Syntax
- source Command
  - Syntax
- status Command
  - Syntax
    - Example
- step Command
  - Native Mode Syntax
  - Java Mode Syntax
- stepi Command
  - Syntax
- stop Command
  - Syntax
    - Native Mode Syntax
    - Java Mode Syntax
- stopi Command
  - Syntax
- suppress Command
  - Syntax
- sync Command
  - Syntax
- syncs Command
  - Syntax
- thread Command
  - Native Mode Syntax
  - Java Mode Syntax
- threads Command
  - Native Mode Syntax
  - Java Mode Syntax
- trace Command
  - Syntax
    - Native Mode Syntax
    - Java Mode Syntax
- tracei Command
  - Syntax
- uncheck Command
  - Syntax
- undisplay Command
  - Native Mode Syntax
  - Java Mode Syntax
- unhide Command
  - Syntax
- unintercept Command
  - Syntax
- unsuppress Command
  - Syntax
- unwatch Command
  - Syntax
- up Command
  - Syntax
- use Command
- watch Command
  - Syntax
- whatis Command
  - Native Mode Syntax
  - Java Mode Syntax
- when Command
  - Syntax
    - Native Mode Syntax
    - Java Mode Syntax
- wheni Command
  - Syntax
- where Command
  - Native Mode Syntax
  - Java Mode Syntax
- whereami Command
  - Syntax
- whereis Command
  - Syntax
- which Command
  - Syntax
- whocatches Command
  - Syntax