Debugging with GDB

The GNU Source-Level Debugger

Fifth Edition, for GDB version 4.17

April 1998

• Note to VxWorks users
• 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
  • Additional process information
  • Debugging programs with multiple threads
  • Debugging programs with multiple processes
• Stopping and Continuing
  • Breakpoints, watchpoints, and exceptions
    • Setting breakpoints
    • Setting watchpoints
    • Breakpoints and exceptions
    • Deleting breakpoints
    • Disabling breakpoints
    • Break conditions
    • Breakpoint command lists
    • Breakpoint menus
  • Continuing and stepping
  • Signals
  • Stopping and starting multi-thread programs
• Examining the Stack
  • Stack frames
  • Backtraces
  • Selecting a frame
  • Information about a frame
  • MIPS machines and the function stack
• 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
    • List of filename extensions and languages
    • Setting the working language
    • Having GDB infer the source language
  • Displaying the language
  • Supported languages
    • C and C++ operators
    • C and C++ constants
    • C++ expressions
    • C and C++ defaults
    • GDB and C
    • GDB features for C++
• 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
• Controlling GDB
  • Prompt
  • Command editing
  • Command history
  • Screen size
  • Numbers
  • Optional warnings and messages
• Canned Sequences of Commands
  • User-defined commands
  • User-defined command hooks
  • Command files
  • Commands for controlled output
• Using GDB under GNU Emacs
• Reporting Bugs in GDB
  • Have you found a bug?
  • How to report bugs
• Command Line Editing
  • Introduction to Line Editing
  • Readline Interaction
    • Readline Bare Essentials
    • Readline Movement Commands
    • Readline Killing Commands
    • Readline Arguments
  • Readline Init File
    • Readline Init Syntax
      • Commands For Moving
      • Commands For Manipulating The History
      • Commands For Changing Text
      • Killing And Yanking
      • Specifying Numeric Arguments
      • Letting Readline Type For You
      • Some Miscellaneous Commands
    • Readline vi Mode
• Using History Interactively
  • History Interaction
    • Event Designators
    • Word Designators
    • Modifiers
• Formatting Documentation
• Installing GDB
  • Compiling GDB in another directory
  • Specifying names for hosts and targets
  • configure options
• Index

This document was generated on 24 March 1999 using the texi2html translator version 1.52.