This file documents the GNU debugger GDB.
This is the Tenth Edition, of Debugging with GDB: the GNU Source-Level Debugger for GDB (GDB) Version 16.0.50.20241126-git.
Copyright © 1988-2024 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with the Invariant Sections being “Free Software” and “Free Software Needs Free Documentation”, with the Front-Cover Texts being “A GNU Manual,” and with the Back-Cover Texts as in (a) below.
(a) The FSF’s Back-Cover Text is: “You are free to copy and modify this GNU Manual. Buying copies from GNU Press supports the FSF in developing GNU and promoting software freedom.”
This file describes GDB, the GNU symbolic debugger.
This is the Tenth Edition, for GDB (GDB) Version 16.0.50.20241126-git.
Copyright (C) 1988-2024 Free Software Foundation, Inc.
This edition of the GDB manual is dedicated to the memory of Fred Fish. Fred was a long-standing contributor to GDB and to Free software in general. We will miss him.
| • Summary: | Summary of GDB | |
| • Sample Session: | A sample GDB session | |
| • Invocation: | Getting in and out of GDB | |
| • Commands: | GDB commands | |
| • Running: | Running programs under GDB | |
| • Stopping: | Stopping and continuing | |
| • Reverse Execution: | Running programs backward | |
| • Process Record and Replay: | Recording inferior’s execution and replaying it | |
| • Stack: | Examining the stack | |
| • Source: | Examining source files | |
| • Data: | Examining data | |
| • Optimized Code: | Debugging optimized code | |
| • Macros: | Preprocessor Macros | |
| • Tracepoints: | Debugging remote targets non-intrusively | |
| • Overlays: | Debugging programs that use overlays | |
| • Languages: | Using GDB with different languages | |
| • Symbols: | Examining the symbol table | |
| • Altering: | Altering execution | |
| • GDB Files: | GDB files | |
| • Targets: | Specifying a debugging target | |
| • Remote Debugging: | Debugging remote programs | |
| • Configurations: | Configuration-specific information | |
| • Controlling GDB: | Controlling GDB | |
| • Extending GDB: | Extending GDB | |
| • Interpreters: | Command Interpreters | |
| • TUI: | GDB Text User Interface | |
| • Emacs: | Using GDB under GNU Emacs | |
| • GDB/MI: | GDB’s Machine Interface. | |
| • Annotations: | GDB’s annotation interface. | |
| • Debugger Adapter Protocol: | The Debugger Adapter Protocol. | |
| • JIT Interface: | Using the JIT debugging interface. | |
| • In-Process Agent: | In-Process Agent | |
| • GDB Bugs: | Reporting bugs in GDB | |
| • Command Line Editing: | Command Line Editing | |
| • Using History Interactively: | Using History Interactively | |
| • In Memoriam: | In Memoriam | |
| • Formatting Documentation: | How to format and print GDB documentation | |
| • Installing GDB: | Installing GDB | |
| • Maintenance Commands: | Maintenance Commands | |
| • Remote Protocol: | GDB Remote Serial Protocol | |
| • Agent Expressions: | The GDB Agent Expression Mechanism | |
| • Target Descriptions: | How targets can describe themselves to GDB | |
| • Operating System Information: | Getting additional information from the operating system | |
| • Trace File Format: | GDB trace file format | |
| • Index Section Format: | .gdb_index section format | |
| • Debuginfod: | Download debugging resources with debuginfod
| |
| • Man Pages: | Manual pages | |
| • Copying: | GNU General Public License says how you can copy and share GDB | |
| • GNU Free Documentation License: | The license for this documentation | |
| • Concept Index: | Index of GDB concepts | |
| • Command and Variable Index: | Index of GDB commands, variables, functions, and Python data types | |
.gdb_index section format