Online Documentation

The purpose of a debugger such as GDB is to allow you to see what is going on “inside” another program while it executes—or what another program was doing at the moment it crashed.

1. A sample GDB Session
2. Getting In and Out of GDB
   1. Invoking GDB
   2. Quitting GDB
   3. Shell Commands
   4. Logging Output
3. GDB Commands
   1. Command Syntax
   2. Command Settings
   3. Command completion
   4. Command Options
   5. Getting Help
4. Running Programs Under GDB
   1. Compiling for Debugging
   2. Starting your Program
   3. Your Programs Arguemnts
   4. Your Programs Environment
   5. Your Programs Working Directory
   6. Your Programs Input & Output
   7. Debugging an Already Running Process
   8. Killing the Child Process
   9. Debugging Multiple Inferiors & Programs
   10. Debugging programs with multiple threads
   11. Debugging forks
   12. Setting a Bookmark to Return to Later
5. Stopping and Continuing
   1. Breakpoints, Watchpoints, and Catchpoints
      1. Setting Breakpoints
      2. Setting Watchpoints
      3. Setting Catchpoints
      4. Deleting Breakpoints
      5. Disabling Breakpoints
      6. Break Conditions
      7. Breakpoint Commands
      8. Dynamic Printf
      9. Saving Breakpoints
      10. Static Probe Points
      11. Errors in Breakpoint
      12. Breakpoint-related Warning
   2. Continuing and Stepping
   3. Skipping Over Functions and Files
   4. Signals
   5. Stopping and Starting Multi-Thread Programs
6. Running Programs Backward
7. Recording Inferior's Execution and Replaying It
8. Examining the Stack
   1. Stack Frames
   2. Backtrace
   3. Selecting a Frame
   4. Information about a Frame
   5. Applying a Command to Several Frames
   6. Management of Frame Filters
9. Examining Source Files
   1. Printing Source Lines
   2. Specifying a Location
      1. Linespec Locations
      2. Explicit Locations
      3. Address Locations
   3. Editing Source Files
   4. Searching Source Files
10. Examining Data
    1. Expressions
    2. Ambiguous Expressions
    3. Program Variables
    4. Artificial Arrays
    5. Output Formats
    6. Examining Memory
    7. Automatic Display
    8. Print Settings
    9. Pretty Printing
       1. Pretty Printer Introduction
       2. Pretty Printer Example
       3. Pretty Printer Commands
    10. Value History
    11. Convenience Variables
    12. Convenience Functions
    13. Register
    14. Floating Point Hardware
    15. Vector Unit
    16. OS Auxilary Information
    17. Memory Region Attributes
    18. Copy Between Memory and a File
    19. Core Files
    20. Character Sets
    21. Searching Memory
    22. Search Memory
11. Debugging Optimized Code
12. C Preprocessor Macros
13. Tracepoints
14. Debugging Programs That Use Overlays
15. Using GDB with Different Languages
16. Examining the Symbol Table
17. Altering Execution
    1. Assignment
    2. Jumping
    3. Signaling
    4. Returning
    5. Calling
    6. Patching
    7. Compiling and Injecting code
18. GDB Files
    1. Files
    2. File caching
    3. Separate Debug File
    4. MiniDebugInfo
    5. Index Files
    6. Symbol Errors
    7. Data Files
19. Specifiying a Debugging target
    1. Byte Order
20. Debugging Remote Programs
21. Configuration-Specific Information
22. Controlling GDB
23. Extending GDB
24. Command Interpreters
25. GDB TUI
    1. Overview
    2. Keys
    3. Single Key Mode
    4. Commands
    5. Configurations