[
Top
]
[
Contents
]
[
Index
]
[
?
]
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
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
This document was generated by
Stephane Carrez
on
January, 3 2003
using
texi2html