Tru64 UNIX
Ladebug Debugger Manual

Contents

Preface
Preface	Preface
Part 1
Part 1	Overview of the Debugger
Chapter 1
1	Introduction to Debugging
1.1	Overview of Debugging Concepts
1.2	Basic Debugging Technique
1.3	Key Features of the Ladebug Debugger
1.4	User Interface Options
1.5	Ladebug Commands Summary
1.6	Preparing for and Starting a Debugging Session
1.6.1	Compiling and Linking a Program
1.6.2	Starting the Debugger Within CDE
1.6.3	Starting the Debugger Within Emacs
1.6.3.1	Loading Ladebug-Specific Emacs Lisp Code
1.6.3.2	Invoking Ladebug Within Emacs
1.6.3.3	Emacs Debugging Buffers
1.6.4	Starting the Debugger from the Shell
1.6.4.1	Invoking the Debugger from the Shell
1.6.4.2	Bringing a Program Under Debugger Control from the Ladebug Prompt
1.6.5	When Your Program Completes Execution
1.6.6	Rerunning the Same Program from the Current Debugging Session
1.6.7	Running Another Program from the Current Debugging Session
1.6.8	Interrupting Program Execution and Aborting Debugger Operations
1.6.9	Ending a Debugging Session
1.7	Searching and Editing Your Program
1.8	Using Online Help
1.8.1	Quick Help Panel
1.8.2	Displaying Context-Sensitive Help
1.8.3	Displaying Command-Oriented Help
1.9	Support for International Users
1.9.1	Support for Input of Local Language Characters in User Commands
1.9.2	Support for Output of Local Language Characters
1.9.3	Support for Wide Character Type (wchar_t) in C and C++ Programs
Part 2
Part 2	Basic Debugging
Chapter 2
2	Examining Program Information
2.1	Displaying the Source Code of Your Program
2.1.1	Displaying Source Code Contained in Another Module
2.1.2	Making Source Code Available for Display
2.2	Accessing Program Variables
2.2.1	How the Debugger Searches for Variables and Other Symbols
2.2.2	GUI Options for Selecting and Changing Variables and Values
2.2.3	Selecting Variable Names from Windows
2.2.4	Listing and Displaying Variables
2.2.5	Displaying the Current Value of a Variable
2.2.5.1	Using the Local Variables View
2.2.5.2	Using the Print Button
2.2.5.3	Using the Print Dialog Box
2.2.5.4	Using the Monitor View
2.2.5.4.1	Monitoring an Aggregate (Array, Structure) Variable
2.2.5.4.2	Monitoring a Pointer (Access) Variable
2.2.5.4.3	Dereferencing Pointers
2.2.6	Changing the Current Value of a Variable
2.2.6.1	Clicking on a Monitored Value Within the Local Variables View or Monitor View
2.2.6.2	Changing the Value of a Variable with the Assign Dialog Box
2.3	Displaying and Modifying Values Stored in Registers
2.4	Displaying the Decoded Instruction Stream of Your Program
2.5	Displaying the Call Stack
2.6	Examining and Changing The Current Context
2.6.1	Changing the Current Language Context
Chapter 3
3	Controlling Program Execution
3.1	Determining Where Execution Is Currently Paused
3.2	Executing Your Program
3.2.1	Starting or Resuming Program Execution
3.2.2	Executing Your Program One Source Line at a Time
3.2.3	Stepping into a Called Routine
3.2.4	Returning from a Called Routine
3.2.5	Branching to a Specified Line
3.2.6	Calling a Function
3.2.7	Removing Execution Frames from the Call Stack
3.2.8	Attaching to a Running Process
3.3	Setting Breakpoints to Suspend Execution
3.3.1	Identifying Currently Set Breakpoints
3.3.2	Setting Breakpoints on Source Lines
3.3.2.1	Using the Command Interface to Set Breakpoints
3.3.2.2	Deactivating (Disabling) and Activating (Enabling) Breakpoints, Tracepoints, and Watchpoints
3.3.3	Setting Breakpoints on Routines
3.3.4	Setting and Modifying Conditional Breakpoints
3.3.5	Setting and Modifying Action Breakpoints
3.3.6	Deleting Breakpoints
3.4	Setting Tracepoints for Event Notification
3.4.1	Tracepoints That Notify You of Function Entry and Exit
3.4.2	Tracepoints That Notify You of a Variable Value Change
3.5	Setting Watchpoints to Monitor Variables and Other Program Locations
3.5.1	Setting Watchpoints for Addresses
3.5.2	Setting Watchpoints for Variables
3.6	Catching Unaligned Data Accesses
3.7	Debugging Programs with Stripped Images
3.8	Using Environment Variables Within the Debugger