Debugging a Program With dbx

Book Information
Preface
Chapter 1 Starting dbx
- Basic Concepts
- Starting a Debugging Session
- Setting Startup Properties
- Debugging Optimized Code
- Quitting Debugging
- Saving and Restoring a Debugging Run
- Command Reference
  - Syntax
  - Start-up Options
Chapter 2 Customizing dbx
- Using the .dbxrc File
  - Creating a .dbxrc File
  - A Sample Initialization File
- dbx Environment Variables and the Korn Shell
- Customizing dbx in Sun WorkShop
- Command Reference
Chapter 3 Viewing and Visiting Code
- Mapping to the Location of the Code
- Visiting Code
- Qualifying Symbols with Scope Resolution Operators
- Locating Symbols
  - Printing a List of Occurrences of a Symbol
  - Determining Which Symbol dbx Uses
- Viewing Variables, Members, Types, and Classes
  - Looking Up Definitions of Variables, Members, and Functions
  - Looking Up Definitions of Types and Classes
- Using the Auto-Read Facility
  - Debugging Without the Presence of .o Files
  - Listing Modules
- Command Reference
Chapter 4 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
- Command Reference
  - run
  - rerun
  - next
  - cont
  - step
  - debug
  - detach
Chapter 5 Setting Breakpoints and Traces
- Basic Concepts
- Setting Breakpoints
- Tracing Code
  - Setting a Trace
  - Controlling the Speed of a Trace
- Listing and Clearing Event Handlers
- Setting Breakpoint Filters
- Efficiency Considerations
Chapter 6 Event Management
- Basic Concepts
- Creating Event Handlers
- Manipulating Event Handlers
- Using Event Counters
- Setting Event Specifications
- Parsing and Ambiguity
- Using Predefined Variables
  - Event-Specific Variables
    - $handlerid
    - $booting
  - Variables Valid for the Given Event
- Examples
- Command Reference
Chapter 7 Examining the Call Stack
- Finding Your Place on the Stack
- Walking the Stack and Returning Home
- Moving Up and Down the Stack
  - Moving to a Specific Frame
- Command Reference
  - where
  - hide/unhide
Chapter 8 Evaluating and Displaying Data
- Evaluating Variables and Expressions
- Assigning a Value to a Variable
- Evaluating Arrays
  - Array Slicing for Arrays
  - Syntax for Array Slicing and Striding
    - Slices
    - Strides
- Command Reference
  - print
Chapter 9 Using Runtime Checking
- Basic Concepts
- Using RTC
- Using Access Checking (SPARC only)
  - Understanding the Memory Access Error Report
  - Memory Access Errors
- Using Memory Leak Checking
- Using Memory Use Checking
- Suppressing Errors
  - Default Suppressions
  - Using Suppression to Manage Errors
- Using RTC on a Child Process
- Using RTC on an Attached Process
- Using Fix and Continue With RTC
- Runtime Checking Application Programming Interface
- Using RTC in Batch Mode
- Troubleshooting Tips
  - RTC's Eight Megabyte Limit
    - Working Around the Eight Megabyte Limit
  - rtc_patch_area
    - Examples
- Command Reference
Chapter 10 Data Visualization
- Specifying Proper Array Expressions
  - Graphing an Array
- Automatic Updating of Array Displays
- Changing Your Display
- Analyzing Visualized Data
- Fortran Example Program
- C Example Program
Chapter 11 Fixing and Continuing
- Basic Concepts
  - How fix and continue Operates
  - Modifying Source Using fix and continue
    - Restrictions
- Fixing Your Program
  - Continuing after Fixing
- Changing Variables after Fixing
- Command Reference
Chapter 12 Debugging Multithreaded Applications
- Understanding Multithreaded Debugging
- Understanding LWP Information
- Command Reference
Chapter 13 Debugging Child Processes
- Attaching to Child Processes
- Following the exec
- Following fork
- Interacting with Events
Chapter 14 Working With Signals
- Understanding Signal Events
- Catching Signals
  - Changing the Default Signal Lists
  - Trapping the FPE Signal
    - Determining Where the Exception Occurred
    - Determining the Cause of the Exception
- Sending a Signal in a Program
- Automatically Handling Signals
Chapter 15 Collecting Data
- Using the Sampling Collector
- Profiling
- Collecting Data for Multithreaded Applications
- Command Reference
Chapter 16 Debugging C++
- Using dbx with C++
- Exception Handling in dbx
  - Commands for Handling Exceptions
  - Examples of Exception Handling
- Debugging With C++ Templates
  - Template Example
- Command Reference
  - Commands for C++ Templates
Chapter 17 Debugging Fortran Using dbx
- Debugging Fortran
- Debugging Segmentation Faults
  - Using dbx to Locate Problems
- Locating Exceptions
- Tracing Calls
- Working With Arrays
  - Fortran 90 Allocatable Arrays
  - Slicing Arrays
- Showing Intrinsic Functions
- Showing Complex Expressions
- Showing Logical Operators
- Viewing Fortran 90 Derived Types
- Pointer to Fortran 90 Derived Type
- Fortran 90 Generic Functions
Chapter 18 Debugging at the Machine-Instruction Level
- Examining the Contents of Memory
- Stepping and Tracing at Machine-Instruction Level
  - Single-Stepping the Machine-Instruction Level
  - Tracing at the Machine-Instruction Level
- Setting Breakpoints at Machine-Instruction Level
  - Setting a Breakpoint at an Address
- Using the adb Command
- Using the regs Command
Chapter 19 Using dbx With the Korn Shell
- ksh-88 Features Not Implemented
- Extensions to ksh-88
- Renamed Commands
Chapter 20 Debugging Shared Libraries
- Basic Concepts
- Debugging Support for Preloaded Shared Objects
- Fix and Continue
- Setting a Breakpoint in a Dynamically Linked Library
Appendix A Modifying a Program State
- Impacts of Running a Program Under dbx
- Commands That Alter the State of the Program
  - assign
  - pop
  - call
  - print
  - when
  - fix
  - cont at
Appendix B Incremental Link Editor (ild)
- Introduction
- Overview of Incremental Linking
- How to Use ild
- How ild Works
- What ild Cannot Do
- Reasons for Full Relinks
- Options
  - Options Accepted by the Compilation System
  - Options Passed to ild from the Compilation System
- Environment
- Notes
  - ld Options Not Supported by ild
  - Files Used by ild
Appendix C User Tips
- Using dbx Equivalents for Common GDB Commands
- Changes in dbx Since Release 2.0.1
- Enabling Command-Line Editing
- Being In Scope
- Locating Files
- Reaching Breakpoints
  - C++ members and whatis Command
  - Runtime Checking Eight Megabyte Limit
- Using dbx to Locate Floating-Point Exceptions
- Using dbx with Multithreaded Programs