Debugging with GDB

The GNU Source-Level Debugger

Seventh Edition, for GDB version 20000204

February 1999

• 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
    • Setting breakpoints
    • Setting watchpoints
    • Setting catchpoints
    • Deleting breakpoints
    • Disabling breakpoints
    • Break conditions
    • Breakpoint command lists
    • Breakpoint menus
    • "Cannot insert breakpoints"
  • 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
    • List of filename extensions and languages
    • Setting the working language
    • Having GDB infer the source language
  • Displaying the language
  • Type and range checking
    • An overview of type checking
    • An overview of range checking
  • Supported languages
    • C and C++
      • C and C++ operators
      • C and C++ constants
      • C++ expressions
      • C and C++ defaults
      • C and C++ type and range checks
      • GDB and C
      • GDB features for C++
    • Objective-C/C++
      • Method Names in Commands
      • Command Descriptions
      • Objective-C/C++ Expressions
    • PostScript
    • Modula-2
      • Operators
      • Built-in functions and procedures
      • Constants
      • Modula-2 defaults
      • Deviations from standard Modula-2
      • Modula-2 type and range checks
      • The scope operators :: and .
      • GDB and Modula-2
    • Chill
      • How modes are displayed
      • Locations and their accesses
      • Values and their Operations
      • Chill type and range checks
      • Chill defaults
• 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
      • What the stub can do for you
      • What you must do for the stub
      • Putting it all together
      • Communication protocol
      • Using the gdbserver program
      • Using the gdbserve.nlm program
  • Kernel Object Display
• Configuration-Specific Information
  • Native
    • HP-UX
    • SVR4 process information
  • Embedded Operating Systems
    • Using GDB with VxWorks
      • Connecting to VxWorks
      • VxWorks download
      • Running tasks
  • Embedded Processors
    • AMD A29K Embedded
      • A29K UDI
      • EBMON protocol for AMD29K
      • Communications setup
      • EB29K cross-debugging
      • Remote log
    • ARM
    • Hitachi H8/300
      • Connecting to Hitachi boards
      • Using the E7000 in-circuit emulator
      • Special GDB commands for Hitachi micros
    • H8/500
    • Intel i960
      • Startup with Nindy
      • Options for Nindy
      • Nindy reset command
    • Mitsubishi M32R/D
    • M68k
    • M88K
    • MIPS Embedded
    • PowerPC
    • HP PA Embedded
    • Hitachi SH
    • Tsqware Sparclet
      • Setting file to debug
      • Connecting to Sparclet
      • Sparclet download
      • Running and debugging
    • Fujitsu Sparclite
    • Tandem ST2000
    • Zilog Z8000
  • Architectures
    • A29K
    • Alpha
    • MIPS
• 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
• Formatting Documentation
• Installing GDB
  • Compiling GDB in another directory
  • Specifying names for hosts and targets
  • configure options
• Index

This document was generated on 8 April 2000 using the texi2html translator version 1.51.