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.1.1 Choosing files
2.1.2 Choosing modes

2.2 Quitting GDB
2.3 Shell commands

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 programs with multiple threads
4.10 Debugging programs with multiple processes

5. Stopping and Continuing

5.1 Breakpoints, watchpoints, and catchpoints

5.1.1 Setting breakpoints
5.1.2 Setting watchpoints
5.1.3 Setting catchpoints
5.1.4 Deleting breakpoints
5.1.5 Disabling breakpoints
5.1.6 Break conditions
5.1.7 Breakpoint command lists
5.1.8 Breakpoint menus
5.1.9 "Cannot insert breakpoints"

5.2 Continuing and stepping
5.3 Signals
5.4 Stopping and starting multi-thread programs

6. Examining the Stack

6.1 Stack frames
6.2 Backtraces
6.3 Selecting a frame
6.4 Information about a frame

7. Examining Source Files

7.1 Printing source lines
7.2 Searching source files
7.3 Specifying source directories
7.4 Source and machine code

8. Examining Data

8.1 Expressions
8.2 Program variables
8.3 Artificial arrays
8.4 Output formats
8.5 Examining memory
8.6 Automatic display
8.7 Print settings
8.8 Value history
8.9 Convenience variables
8.10 Registers
8.11 Floating point hardware
8.12 Memory region attributes

8.12.1 Attributes

8.12.1.1 Memory Access Mode
8.12.1.2 Memory Access Size
8.12.1.3 Data Cache

8.13 Copy between memory and a file

9. Tracepoints

9.1 Commands to Set Tracepoints

9.1.1 Create and Delete Tracepoints
9.1.2 Enable and Disable Tracepoints
9.1.3 Tracepoint Passcounts
9.1.4 Tracepoint Action Lists
9.1.5 Listing Tracepoints
9.1.6 Starting and Stopping Trace Experiment

9.2 Using the collected data

9.2.1 tfind n
9.2.2 tdump
9.2.3 save-tracepoints filename

9.3 Convenience Variables for Tracepoints

10. Debugging Programs That Use Overlays

10.1 How Overlays Work
10.2 Overlay Commands
10.3 Automatic Overlay Debugging
10.4 Overlay Sample Program

11. Using GDB with Different Languages

11.1 Switching between source languages

11.1.1 List of filename extensions and languages
11.1.2 Setting the working language
11.1.3 Having GDB infer the source language

11.2 Displaying the language
11.3 Type and range checking

11.3.1 An overview of type checking
11.3.2 An overview of range checking

11.4 Supported languages

11.4.1 C and C++

11.4.1.1 C and C++ operators
11.4.1.2 C and C++ constants
11.4.1.3 C++ expressions
11.4.1.4 C and C++ defaults
11.4.1.5 C and C++ type and range checks
11.4.1.6 GDB and C
11.4.1.7 GDB features for C++

11.4.2 Modula-2

11.4.2.1 Operators
11.4.2.2 Built-in functions and procedures
11.4.2.3 Constants
11.4.2.4 Modula-2 defaults
11.4.2.5 Deviations from standard Modula-2
11.4.2.6 Modula-2 type and range checks
11.4.2.7 The scope operators :: and .
11.4.2.8 GDB and Modula-2

11.4.3 Chill

11.4.3.1 How modes are displayed
11.4.3.2 Locations and their accesses
11.4.3.3 Values and their Operations
11.4.3.4 Chill type and range checks
11.4.3.5 Chill defaults

12. Examining the Symbol Table
13. Altering Execution

13.1 Assignment to variables
13.2 Continuing at a different address
13.3 Giving your program a signal
13.4 Returning from a function
13.5 Calling program functions
13.6 Patching programs

14. GDB Files

14.1 Commands to specify files
14.2 Errors reading symbol files

15. Specifying a Debugging Target

15.1 Active targets
15.2 Commands for managing targets
15.3 Choosing target byte order
15.4 Remote debugging
15.5 Kernel Object Display

16. Debugging remote programs

16.1 Using the gdbserver program
16.2 Using the gdbserve.nlm program
16.3 Implementing a remote stub

16.3.1 What the stub can do for you
16.3.2 What you must do for the stub
16.3.3 Putting it all together

17. Configuration-Specific Information

17.1 Native

17.1.1 HP-UX
17.1.2 SVR4 process information
17.1.3 Features for Debugging DJGPP Programs
17.1.4 Features for Debugging MS Windows PE executables

17.2 Embedded Operating Systems

17.2.1 Using GDB with VxWorks

17.2.1.1 Connecting to VxWorks
17.2.1.2 VxWorks download
17.2.1.3 Running tasks

17.3 Embedded Processors

17.3.1 ARM
17.3.2 Hitachi H8/300

17.3.2.1 Connecting to Hitachi boards
17.3.2.2 Using the E7000 in-circuit emulator
17.3.2.3 Special GDB commands for Hitachi micros

17.3.3 H8/500
17.3.4 Intel i960

17.3.4.1 Startup with Nindy
17.3.4.2 Options for Nindy
17.3.4.3 Nindy reset command

17.3.5 Mitsubishi M32R/D
17.3.6 M68k
17.3.7 M88K
17.3.8 MIPS Embedded
17.3.9 PowerPC
17.3.10 HP PA Embedded
17.3.11 Hitachi SH
17.3.12 Tsqware Sparclet

17.3.12.1 Setting file to debug
17.3.12.2 Connecting to Sparclet
17.3.12.3 Sparclet download
17.3.12.4 Running and debugging

17.3.13 Fujitsu Sparclite
17.3.14 Tandem ST2000
17.3.15 Zilog Z8000

17.4 Architectures

17.4.1 A29K
17.4.2 Alpha
17.4.3 MIPS

18. Controlling GDB

18.1 Prompt
18.2 Command editing
18.3 Command history
18.4 Screen size
18.5 Numbers
18.6 Optional warnings and messages
18.7 Optional messages about internal happenings

19. Canned Sequences of Commands

19.1 User-defined commands
19.2 User-defined command hooks
19.3 Command files
19.4 Commands for controlled output

20. GDB Text User Interface

20.1 TUI overview
20.2 TUI Key Bindings
20.3 TUI specific commands
20.4 TUI configuration variables

21. Using GDB under GNU Emacs
22. GDB Annotations

22.1 What is an Annotation?
22.2 The Server Prefix
22.3 Values
22.4 Frames
22.5 Displays
22.6 Annotation for GDB Input
22.7 Errors
22.8 Information on Breakpoints
22.9 Invalidation Notices
22.10 Running the Program
22.11 Displaying Source
22.12 Annotations We Might Want in the Future

23. The GDB/MI Interface

Function and Purpose
Notation and Terminology
23.1 GDB/MI Command Syntax

23.1.1 GDB/MI Input Syntax
23.1.2 GDB/MI Output Syntax
23.1.3 Simple Examples of GDB/MI Interaction

23.2 GDB/MI Compatibility with CLI
23.3 GDB/MI Output Records

23.3.1 GDB/MI Result Records
23.3.2 GDB/MI Stream Records
23.3.3 GDB/MI Out-of-band Records

23.4 GDB/MI Command Description Format
23.5 GDB/MI Breakpoint table commands
23.6 GDB/MI Data Manipulation
23.7 GDB/MI Program control
23.8 Miscellaneous GDB commands in GDB/MI
23.9 GDB/MI Stack Manipulation Commands
23.10 GDB/MI Symbol Query Commands
23.11 GDB/MI Target Manipulation Commands
23.12 GDB/MI Thread Commands
23.13 GDB/MI Tracepoint Commands
23.14 GDB/MI Variable Objects

24. Reporting Bugs in GDB

24.1 Have you found a bug?
24.2 How to report bugs

25. Command Line Editing

25.1 Introduction to Line Editing
25.2 Readline Interaction

25.2.1 Readline Bare Essentials
25.2.2 Readline Movement Commands
25.2.3 Readline Killing Commands
25.2.4 Readline Arguments
25.2.5 Searching for Commands in the History

25.3 Readline Init File

25.3.1 Readline Init File Syntax
25.3.2 Conditional Init Constructs
25.3.3 Sample Init File

25.4 Bindable Readline Commands

25.4.1 Commands For Moving
25.4.2 Commands For Manipulating The History
25.4.3 Commands For Changing Text
25.4.4 Killing And Yanking
25.4.5 Specifying Numeric Arguments
25.4.6 Letting Readline Type For You
25.4.7 Keyboard Macros
25.4.8 Some Miscellaneous Commands

25.5 Readline vi Mode

26. Using History Interactively

26.1 History Expansion

26.1.1 Event Designators
26.1.2 Word Designators
26.1.3 Modifiers

A. Formatting Documentation
B. Installing GDB

B.1 Compiling GDB in another directory
B.2 Specifying names for hosts and targets
B.3 configure options

C. Maintenance Commands
D. GDB Remote Serial Protocol
E. GNU GENERAL PUBLIC LICENSE

Preamble
How to Apply These Terms to Your New Programs

F. GNU Free Documentation License

ADDENDUM: How to use this License for your documents

Index