Debugging with GDB

The GNU Source-Level Debugger

Eighth Edition, for GDB version 5.0

March 2000

Richard Stallman, Roland Pesch, Stan Shebs, et.al.

Summary of GDB
- Free software
- Contributors to GDB
A Sample GDB Session
Getting In and Out of GDB
- Invoking GDB
  - Choosing files
  - Choosing modes
- Quitting GDB
- Shell commands
GDB Commands
- Command syntax
- Command completion
- Getting help
Running Programs Under GDB
- Compiling for debugging
- Starting your program
- Your program's arguments
- Your program's environment
- Your program's working directory
- Your program's input and output
- Debugging an already-running process
- Killing the child process
- Debugging programs with multiple threads
- Debugging programs with multiple processes
Stopping and Continuing
- Breakpoints, watchpoints, and catchpoints
- Continuing and stepping
- Signals
- Stopping and starting multi-thread programs
Examining the Stack
- Stack frames
- Backtraces
- Selecting a frame
- Information about a frame
Examining Source Files
- Printing source lines
- Searching source files
- Specifying source directories
- Source and machine code
Examining Data
- Expressions
- Program variables
- Artificial arrays
- Output formats
- Examining memory
- Automatic display
- Print settings
- Value history
- Convenience variables
- Registers
- Floating point hardware
Using GDB with Different Languages
- Switching between source languages
- Displaying the language
- Type and range checking
  - An overview of type checking
  - An overview of range checking
- Supported languages
Examining the Symbol Table
Altering Execution
- Assignment to variables
- Continuing at a different address
- Giving your program a signal
- Returning from a function
- Calling program functions
- Patching programs
GDB Files
- Commands to specify files
- Errors reading symbol files
Specifying a Debugging Target
- Active targets
- Commands for managing targets
- Choosing target byte order
- Remote debugging
  - The GDB remote serial protocol
- Kernel Object Display
Configuration-Specific Information
- Native
  - HP-UX
  - SVR4 process information
- Embedded Operating Systems
  - Using GDB with VxWorks
- Embedded Processors
- Architectures
Controlling GDB
- Prompt
- Command editing
- Command history
- Screen size
- Numbers
- Optional warnings and messages
- Optional messages about internal happenings
Canned Sequences of Commands
- User-defined commands
- User-defined command hooks
- Command files
- Commands for controlled output
Using GDB under GNU Emacs
GDB Annotations
- What is an Annotation?
- The Server Prefix
- Values
- Frames
- Displays
- Annotation for GDB Input
- Errors
- Information on Breakpoints
- Invalidation Notices
- Running the Program
- Displaying Source
- Annotations We Might Want in the Future
The GDB/MI Interface
- Function and Purpose
- Notation and Terminology
- GDB/MI Command Syntax
- GDB/MI Compatibility with CLI
- GDB/MI Output Records
- GDB/MI Command Description Format
- GDB/MI Breakpoint table commands
- GDB/MI Data Manipulation
- GDB/MI Program control
- Miscellaneous GDB commands in GDB/MI
- Stack manipulation commands in GDB/MI
- GDB/MI Symbol Query Commands
- GDB/MI Target Manipulation Commands
- GDB/MI Thread Commands
- GDB/MI Tracepoint Commands
- GDB/MI Variable Objects
- GDB/MI Draft Changes to Output Syntax
Reporting Bugs in GDB
- Have you found a bug?
- How to report bugs
Command Line Editing
- Introduction to Line Editing
- Readline Interaction
- Readline Init File
- Bindable Readline Commands
- Readline vi Mode
Using History Interactively
- History Expansion
Formatting Documentation
Installing GDB
- Compiling GDB in another directory
- Specifying names for hosts and targets
- configure options
Index

This document was generated on 12 September 2000 using texi2html 1.56k.