What is GDB?

GDB, the GNU Project debugger, allows you to see what is going on `inside' another program while it executes -- or what another program was doing at the moment it crashed.

GDB can do four main kinds of things (plus other things in support of these) to help you catch bugs in the act:

• Start your program, specifying anything that might affect its behavior.
• Make your program stop on specified conditions.
• Examine what has happened, when your program has stopped.
• Change things in your program, so you can experiment with correcting the effects of one bug and go on to learn about another.

What Languages does GDB Support?

• Ada
• Assembly
• C
• C++
• D
• Fortran
• Go
• Objective-C
• OpenCL
• Modula-2
• Pascal
• Rust

GDB version 8.1.1

An errata list (PROBLEMS) and documentation are also available.

News

September 5th, 2018: GDB 8.2 Released!

The latest version of GDB, version 8.2, is available for download.

This version of GDB includes the following changes and enhancements:

• Support for the following target has been added:
  • RiscV ELF (riscv*-*-elf)
• Support for following targets and native configurations has been removed:
  • m88k running OpenBSD (m88*-*-openbsd*)
  • SH-5/SH64 ELF (sh64-*-elf*)
  • SH-5/SH64 (sh*)
  • SH-5/SH64 running GNU/Linux (sh*-*-linux*)
  • SH-5/SH64 running OpenBSD (sh*-*-openbsd*)
• Various Python API enhancements
• Aarch64/Linux enhancements:
  • SVE support.
  • Hardware watchpoints improvements for entities stored at unaligned addresses.
    • New "c" response to disable the pager for the rest of the current command.
    • C expressions can now use _Alignof, and C++ expressions can now use alignof.
    • Improved flexibility for loading symbol files.
    • The 'info proc' command nows works on running processes on FreeBSD systems as well as core files created on FreeBSD systems.
    • A new --enable-codesign=CERT configure option to automatically codesign GDB after build (useful on MacOS X).
    See the NEWS file for a more complete and detailed list of what this release includes.

July 31st, 2018: GDB 8.1.1 Released!

The latest version of GDB, version 8.1.1, is available for download.

This is a minor corrective release over GDB 8.1, fixing the following issues:

• PR gdb/22824 (misleading description of new rbreak Python function in GDB 8.1 NEWS file)
• PR gdb/22849 (ctrl-c doesn't work in extended-remote)
• PR gdb/22907 ([Regression] gdbserver doesn't work with filename-only binaries)
• PR gdb/23028 (inconsistent disassemble of vcvtpd2dq)
• PR gdb/23053 (Fix -D_GLIBCXX_DEBUG gdb-add-index regression)
• PR gdb/23127 ([AArch64] GDB cannot be used for debugging software that uses high Virtual Addresses)
• PR server/23158 (gdbserver no longer functional on Windows)
• PR breakpoints/23210 ([8.1/8.2 Regression] Bogus Breakpoint address adjusted from 0xf7fe7dd3 to 0xfffffffff7fe7dd3)

July 4th, 2018: GDB 8.2 branch created

The GDB 8.2 branch (gdb-8.2-branch) has been created. To check out a copy of the branch use:

git clone --branch gdb-8.2-branch ssh://sourceware.org/git/binutils-gdb.git

September 30, 2011: Release Mistakes in GDB Versions 6.0 - 7.3

A mistake has been detected in the release tar files for all GDB releases from version 6.0 to version 7.3 (included). The mistake has been corrected, and the FSF issued the following announcements:

• Making up for a release mistake in GDB versions 6.0 - 6.6
• Making up for a release mistake in GDB versions 6.7 - 7.3

Nov 28, 2006: Reversible Debugging

The GDB maintainers are looking for contributors interested in reversible debugging.