OpenVMS Debugger Manual

Contents

Preface
Preface	Preface
Part I
Part I	Introduction to the Debugger
Chapter 1
1	Introduction to the Debugger
1.1	Overview of the Debugger
1.1.1	Functional Features
1.1.2	Convenience Features
1.2	Preparing an Executable Image for Debugging
1.2.1	Compiling a Program for Debugging
1.2.2	Linking a Program for Debugging
1.2.3	Controlling Debugger Activation with the LINK and RUN Commands
1.3	Debugging a Program with the Kept Debugger
1.3.1	Starting the Kept Debugger
1.3.2	When Your Program Completes Execution
1.3.3	Rerunning the Same Program from the Kept Debugger
1.3.4	Running Another Program from the Kept Debugger
1.4	Interrupting Program Execution and Aborting Debugger Commands
1.5	Pausing and Resuming a Debugging Session
1.6	Starting the Debugger by Running a Program
1.7	Starting the Debugger After Interrupting a Running Program
1.8	Ending a Debugging Session
1.9	Debugging a Program on a Workstation Running DECwindows Motif
1.10	Debugging a Program from a PC Running the Debug Client
1.11	Debugging Detached Processes That Run with No CLI
1.12	Configuring Process Quotas for the Debugger
1.13	Debugger Command Summary
1.13.1	Starting and Ending a Debugging Session
1.13.2	Controlling and Monitoring Program Execution
1.13.3	Examining and Manipulating Data
1.13.4	Controlling Type Selection and Radix
1.13.5	Controlling Symbol Searches and Symbolization
1.13.6	Displaying Source Code
1.13.7	Using Screen Mode
1.13.8	Editing Source Code
1.13.9	Defining Symbols
1.13.10	Using Keypad Mode
1.13.11	Using Command Procedures, Log Files, and Initialization Files
1.13.12	Using Control Structures
1.13.13	Debugging Multiprocess Programs
1.13.14	Additional Commands
Part II
Part II	Command Interface
Chapter 2
2	Getting Started with the Debugger
2.1	Entering Debugger Commands and Accessing Online Help
2.2	Displaying Source Code
2.2.1	Noscreen Mode
2.2.2	Screen Mode
2.3	Controlling and Monitoring Program Execution
2.3.1	Starting or Resuming Program Execution
2.3.2	Executing the Program by Step Unit
2.3.3	Determining Where Execution Is Paused
2.3.4	Suspending Program Execution with Breakpoints
2.3.5	Tracing Program Execution with Tracepoints
2.3.6	Monitoring Changes in Variables with Watchpoints
2.4	Examining and Manipulating Program Data
2.4.1	Displaying the Value of a Variable
2.4.2	Assigning a Value to a Variable
2.4.3	Evaluating Language Expressions
2.5	Controlling Access to Symbols in Your Program
2.5.1	Setting and Canceling Modules
2.5.2	Resolving Symbol Ambiguities
2.6	Sample Debugging Session
Chapter 3
3	Controlling and Monitoring Program Execution
3.1	Commands Used to Execute the Program
3.2	Executing the Program by Step Unit
3.2.1	Changing the STEP Command Behavior
3.2.2	Stepping Into and Over Routines
3.3	Suspending and Tracing Execution with Breakpoints and Tracepoints
3.3.1	Setting Breakpoints or Tracepoints on Individual Program Locations
3.3.1.1	Specifying Symbolic Addresses
3.3.1.2	Specifying Locations in Memory
3.3.1.3	Obtaining and Symbolizing Memory Addresses
3.3.2	Setting Breakpoints or Tracepoints on Lines or Instructions
3.3.3	Setting Breakpoints on Emulated Instructions (Alpha Only)
3.3.4	Controlling Debugger Action at Breakpoints or Tracepoints
3.3.5	Setting Breakpoints or Tracepoints on Exceptions
3.3.6	Setting Breakpoints or Tracepoints on Events
3.3.7	Deactivating, Activating, and Canceling Breakpoints or Tracepoints
3.4	Monitoring Changes in Variables and Other Program Locations
3.4.1	Deactivating, Activating, and Canceling Watchpoints
3.4.2	Watchpoint Options
3.4.3	Watching Nonstatic Variables
3.4.3.1	Execution Speed
3.4.3.2	Setting a Watchpoint on a Nonstatic Variable
3.4.3.3	Options for Watching Nonstatic Variables
3.4.3.4	Setting Watchpoints in Installed Writable Shareable Images