Debugging with GDB: Table of Contents

Summary of GDB
- Free Software
- Free Software Needs Free Documentation
- Contributors to GDB
1. A Sample GDB Session
2. Getting In and Out of GDB
- 2.1 Invoking GDB
- 2.2 Quitting GDB
- 2.3 Shell Commands
- 2.4 Logging Output
3. GDB Commands
- 3.1 Command Syntax
- 3.2 Command Completion
- 3.3 Getting Help
4. Running Programs Under GDB
- 4.1 Compiling for Debugging
- 4.2 Starting your Program
- 4.3 Your Program's Arguments
- 4.4 Your Program's Environment
- 4.5 Your Program's Working Directory
- 4.6 Your Program's Input and Output
- 4.7 Debugging an Already-running Process
- 4.8 Killing the Child Process
- 4.9 Debugging Multiple Inferiors
- 4.10 Debugging Programs with Multiple Threads
- 4.11 Debugging Programs with Multiple Processes
- 4.12 Setting a Bookmark to Return to Later
  - 4.12.1 A Non-obvious Benefit of Using Checkpoints
5. Stopping and Continuing
- 5.1 Breakpoints, Watchpoints, and Catchpoints
- 5.2 Continuing and Stepping
- 5.3 Signals
- 5.4 Stopping and Starting Multi-thread Programs
6. Running programs backward
7. Recording Inferior's Execution and Replaying It
8. Examining the Stack
- 8.1 Stack Frames
- 8.2 Backtraces
- 8.3 Selecting a Frame
- 8.4 Information About a Frame
9. Examining Source Files
- 9.1 Printing Source Lines
- 9.2 Specifying a Location
- 9.3 Editing Source Files
  - 9.3.1 Choosing your Editor
- 9.4 Searching Source Files
- 9.5 Specifying Source Directories
- 9.6 Source and Machine Code
10. Examining Data
- 10.1 Expressions
- 10.2 Ambiguous Expressions
- 10.3 Program Variables
- 10.4 Artificial Arrays
- 10.5 Output Formats
- 10.6 Examining Memory
- 10.7 Automatic Display
- 10.8 Print Settings
- 10.9 Value History
- 10.10 Convenience Variables
- 10.11 Registers
- 10.12 Floating Point Hardware
- 10.13 Vector Unit
- 10.14 Operating System Auxiliary Information
- 10.15 Memory Region Attributes
  - 10.15.1 Attributes
  - 10.15.2 Memory Access Checking
- 10.16 Copy Between Memory and a File
- 10.17 How to Produce a Core File from Your Program
- 10.18 Character Sets
- 10.19 Caching Data of Remote Targets
- 10.20 Search Memory
11. Debugging Optimized Code
- 11.1 Inline Functions
12. C Preprocessor Macros
13. Tracepoints
- 13.1 Commands to Set Tracepoints
- 13.2 Using the Collected Data
- 13.3 Convenience Variables for Tracepoints
14. Debugging Programs That Use Overlays
- 14.1 How Overlays Work
- 14.2 Overlay Commands
- 14.3 Automatic Overlay Debugging
- 14.4 Overlay Sample Program
15. Using GDB with Different Languages
- 15.1 Switching Between Source Languages
- 15.2 Displaying the Language
- 15.3 Type and Range Checking
  - 15.3.1 An Overview of Type Checking
  - 15.3.2 An Overview of Range Checking
- 15.4 Supported Languages
- 15.5 Unsupported Languages
16. Examining the Symbol Table
17. Altering Execution
- 17.1 Assignment to Variables
- 17.2 Continuing at a Different Address
- 17.3 Giving your Program a Signal
- 17.4 Returning from a Function
- 17.5 Calling Program Functions
- 17.6 Patching Programs
18. GDB Files
- 18.1 Commands to Specify Files
- 18.2 Debugging Information in Separate Files
- 18.3 Errors Reading Symbol Files
- 18.4 GDB Data Files
19. Specifying a Debugging Target
- 19.1 Active Targets
- 19.2 Commands for Managing Targets
- 19.3 Choosing Target Byte Order
20. Debugging Remote Programs
- 20.1 Connecting to a Remote Target
- 20.2 Sending files to a remote system
- 20.3 Using the gdbserver Program
- 20.4 Remote Configuration
- 20.5 Implementing a Remote Stub
21. Configuration-Specific Information
- 21.1 Native
- 21.2 Embedded Operating Systems
  - 21.2.1 Using GDB with VxWorks
- 21.3 Embedded Processors
- 21.4 Architectures
22. Controlling GDB
- 22.1 Prompt
- 22.2 Command Editing
- 22.3 Command History
- 22.4 Screen Size
- 22.5 Numbers
- 22.6 Configuring the Current ABI
- 22.7 Optional Warnings and Messages
- 22.8 Optional Messages about Internal Happenings
- 22.9 Other Miscellaneous Settings
23. Extending GDB
- 23.1 Canned Sequences of Commands
- 23.2 Scripting GDB using Python
  - 23.2.1 Python Commands
  - 23.2.2 Python API
24. Command Interpreters
25. GDB Text User Interface
- 25.1 TUI Overview
- 25.2 TUI Key Bindings
- 25.3 TUI Single Key Mode
- 25.4 TUI-specific Commands
- 25.5 TUI Configuration Variables
26. Using GDB under GNU Emacs
27. The GDB/MI Interface
- Function and Purpose
- Notation and Terminology
- 27.1 GDB/MI General Design
  - 27.1.1 Context management
  - 27.1.2 Asynchronous command execution and non-stop mode
  - 27.1.3 Thread groups
- 27.2 GDB/MI Command Syntax
  - 27.2.1 GDB/MI Input Syntax
  - 27.2.2 GDB/MI Output Syntax
- 27.3 GDB/MI Compatibility with CLI
- 27.4 GDB/MI Development and Front Ends
- 27.5 GDB/MI Output Records
  - 27.5.1 GDB/MI Result Records
  - 27.5.2 GDB/MI Stream Records
  - 27.5.3 GDB/MI Async Records
  - 27.5.4 GDB/MI Frame Information
- 27.6 Simple Examples of GDB/MI Interaction
- 27.7 GDB/MI Command Description Format
- 27.8 GDB/MI Breakpoint Commands
- 27.9 GDB/MI Program Context
- 27.10 GDB/MI Thread Commands
- 27.11 GDB/MI Program Execution
- 27.12 GDB/MI Stack Manipulation Commands
- 27.13 GDB/MI Variable Objects
- 27.14 GDB/MI Data Manipulation
- 27.15 GDB/MI Tracepoint Commands
- 27.16 GDB/MI Symbol Query Commands
- 27.17 GDB/MI File Commands
- 27.18 GDB/MI Target Manipulation Commands
- 27.19 GDB/MI File Transfer Commands
- 27.20 Miscellaneous GDB/MI Commands
28. GDB Annotations
- 28.1 What is an Annotation?
- 28.2 The Server Prefix
- 28.3 Annotation for GDB Input
- 28.4 Errors
- 28.5 Invalidation Notices
- 28.6 Running the Program
- 28.7 Displaying Source
29. JIT Compilation Interface
- 29.1 JIT Declarations
- 29.2 Registering Code
- 29.3 Unregistering Code
30. Reporting Bugs in GDB
- 30.1 Have You Found a Bug?
- 30.2 How to Report Bugs
31. Command Line Editing
- 31.1 Introduction to Line Editing
- 31.2 Readline Interaction
- 31.3 Readline Init File
- 31.4 Bindable Readline Commands
- 31.5 Readline vi Mode
32. Using History Interactively
- 32.1 History Expansion
A. Formatting Documentation
B. Installing GDB
- B.1 Requirements for Building GDB
- B.2 Invoking the GDB `configure' Script
- B.3 Compiling GDB in Another Directory
- B.4 Specifying Names for Hosts and Targets
- B.5 `configure' Options
- B.6 System-wide configuration and settings
C. Maintenance Commands
D. GDB Remote Serial Protocol
- D.1 Overview
- D.2 Packets
- D.3 Stop Reply Packets
- D.4 General Query Packets
- D.5 Register Packet Format
- D.6 Tracepoint Packets
- D.7 Host I/O Packets
- D.8 Interrupts
- D.9 Notification Packets
- D.10 Remote Protocol Support for Non-Stop Mode
- D.11 Packet Acknowledgment
- D.12 Examples
- D.13 File-I/O Remote Protocol Extension
- D.14 Library List Format
- D.15 Memory Map Format
E. The GDB Agent Expression Mechanism
- E.1 General Bytecode Design
- E.2 Bytecode Descriptions
- E.3 Using Agent Expressions
- E.4 Varying Target Capabilities
- E.5 Tracing on Symmetrix
- E.6 Rationale
F. Target Descriptions
- F.1 Retrieving Descriptions
- F.2 Target Description Format
- F.3 Predefined Target Types
- F.4 Standard Target Features
G. Operating System Information
- G.1 Process list
H. GNU GENERAL PUBLIC LICENSE
- Preamble
- How to Apply These Terms to Your New Programs
I. GNU Free Documentation License
- I.1 ADDENDUM: How to use this License for your documents
Index