Debugging with

The GNU Source-Level Debugger

()

Edition 4.12, for version

January 1994

• Summary of
  • Free software
  • Contributors to GDB
• A Sample Session
• Getting In and Out of
  • Invoking
    • What the stub can do for you
    • What you must do for the stub
    • Putting it all together
    • Communication protocol
    • Using the E7000 in-circuit emulator
    • Special commands for Hitachi micros
    • Choosing files
    • Choosing modes
  • Quitting
  • Shell commands
• Commands
  • Command syntax
  • Command completion
  • Getting help
• Running Programs Under
  • 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
    • "Cannot insert breakpoints"
  • Continuing and stepping
  • 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 with Different Languages
  • Switching between source languages
    • Setting the working language
    • Having infer the source language
  • Displaying the language
  • Supported languages
    • C and C++ operators
    • C and C++ constants
    • C++ expressions
    • C and C++ defaults
    • and C
    • 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
• Files
  • Commands to specify files
  • Errors reading symbol files
• Specifying a Debugging Target
  • Active targets
  • Commands for managing targets
  • Remote debugging
    • What the stub can do for you
    • What you must do for the stub
    • Putting it all together
    • Communication protocol
    • Using the E7000 in-circuit emulator
    • Special commands for Hitachi micros
• Controlling
  • 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 under GNU Emacs
• Reporting Bugs in
  • Have you found a bug?
  • How to report bugs
• Formatting Documentation
• Installing GDB
  • Compiling GDB in another directory
  • Specifying names for hosts and targets
  • configure options
• Index