World Library  
Flag as Inappropriate
Email this Article

GNU Debugger

 

GNU Debugger

GNU Debugger
Developer(s) GNU Project
Initial release 1986 (1986)
Stable release 7.8.1 / October 29, 2014 (2014-10-29)
Written in C
Operating system Unix-like, Windows
Type Debugger
License GNU GPL
Website /gdb/software.org.gnuwww

The GNU Debugger, usually called just GDB and named gdb as an executable file, is the standard debugger for the GNU operating system. However, its use is not strictly limited to the GNU operating system; it is a portable debugger that runs on many Unix-like systems and works for many programming languages, including Ada, C, C++, Objective-C, Free Pascal, Fortran, Java[1] and partially others.[2]

Contents

  • History 1
    • Release history 1.1
  • Technical details 2
    • Features 2.1
    • Remote debugging 2.2
    • Graphical user interface 2.3
  • Examples of commands 3
  • An example session 4
  • See also 5
  • References 6
  • External links 7
    • Documentation 7.1
    • Tutorials 7.2

History

GDB was first written by Richard Stallman in 1986 as part of his GNU system, after his GNU Emacs was "reasonably stable".[3] GDB is free software released under the GNU General Public License (GPL). It was modeled after the DBX debugger, which came with Berkeley Unix distributions.[3]

From 1990 to 1993 it was maintained by John Gilmore while he worked for Cygnus Solutions. Now it is maintained by the GDB Steering Committee which is appointed by the Free Software Foundation.[4]

Release history

  • 2003 October 3: GDB 6.0
  • 2008 March 27: GDB 6.8
  • 2009 October 6: GDB 7.0
  • 2010 March 18: GDB 7.1
  • 2010 September 2: GDB 7.2
  • 2011 July 26: GDB 7.3[5]
  • 2012 January 24: GDB 7.4
  • 2012 April 26: GDB 7.4.1
  • 2012 August 17: GDB 7.5
  • 2012 November 29: GDB 7.5.1
  • 2013 April 26: GDB 7.6
  • 2013 August 30: GDB 7.6.1
  • 2013 December 8: GDB 7.6.2
  • 2014 February 6: GDB 7.7
  • 2014 July 29: GDB 7.8

Technical details

Features

GDB offers extensive facilities for tracing and altering the execution of computer programs. The user can monitor and modify the values of programs' internal variables, and even call functions independently of the program's normal behavior.

GDB target processors (as of 2003) include: Alpha, ARM, AVR, H8/300, Altera Nios/Nios II,System/370, System 390, X86 and its 64-bit extension X86-64, IA-64 "Itanium", Motorola 68000, MIPS, PA-RISC, PowerPC, SuperH, SPARC, and VAX. Lesser-known target processors supported in the standard release have included A29K, ARC, ETRAX CRIS, D10V, D30V, FR-30, FR-V, Intel i960, 68HC11, Motorola 88000, MCORE, MN10200, MN10300, NS32K, Stormy16, and Z8000. (Newer releases will likely not support some of these.) GDB has compiled-in simulators for even lesser-known target processors such like M32R or V850.[6]

GDB is still actively developed. As of version 7.0 new features include support for Python scripting[7] and as of version 7.8 GNU Guile scripting as well.[8] Since version 7.0, support for "reversible debugging" — allowing a debugging session to step backward, much like rewinding a crashed program to see what happened — is available.[9]

Remote debugging

GDB offers a 'remote' mode often used when debugging embedded systems. Remote operation is when GDB runs on one machine and the program being debugged runs on another. GDB can communicate to the remote 'stub' which understands GDB protocol via Serial or TCP/IP.[10] A stub program can be created by linking to the appropriate stub files provided with GDB, which implement the target side of the communication protocol.[11] Alternatively, gdbserver can be used to remotely debug the program without needing to change it in any way.

The same mode is also used by KGDB for debugging a running Linux kernel on the source level with gdb. With KGDB, kernel developers can debug a kernel in much the same way as they debug application programs. It makes it possible to place breakpoints in kernel code, step through the code and observe variables. On architectures where hardware debugging registers are available, watchpoints can be set which trigger breakpoints when specified memory addresses are executed or accessed. KGDB requires an additional machine which is connected to the machine to be debugged using a serial cable or ethernet. On FreeBSD, it is also possible to debug using Firewire direct memory access (DMA).[12]

Graphical user interface

The debugger does not contain its own graphical user interface, and defaults to a command-line interface. Several front-ends have been built for it, such as Xxgdb, Data Display Debugger (DDD), Nemiver, KDbg, Xcode debugger, GDBtk/Insight and the HP Wildebeest Debugger GUI (WDB GUI). IDEs such as Codelite, Code::Blocks, Dev-C++, Geany, GNAT Programming Studio (GPS), KDevelop, Qt Creator, Lazarus, MonoDevelop, Eclipse, NetBeans and VisualStudio (see VS AddIn Gallery) can interface with GDB. GNU Emacs has a "GUD mode" and several tools for VIM exist. These offer facilities similar to debuggers found in IDEs.

Some other debugging tools have been designed to work with GDB, such as memory leak detectors.

Examples of commands

gdb program debug "program" (from the shell)
run -v run the loaded program with the parameters
bt backtrace (in case the program crashed)
info registers dump all registers
disas $pc-32, $pc+32 disassemble

An example session

Consider the following source-code written in C:

#include 
#include 
#include 

size_t foo_len (const char *s)
{
  return strlen (s);
}

int main (int argc, char *argv[])
{
  const char *a = NULL;

  printf ("size of a = %d\n", foo_len (a));

  exit (0);
}

Using the GCC compiler on GNU/Linux, the code above must be compiled using the -g flag in order to include appropriate debug information on the binary generated, thus making it possible to inspect it using GDB. Assuming that the file containing the code above is named example.c, the command for the compilation could be:

 $ gcc example.c -g -o example

And the binary can now be run:

 $ ./example
 Segmentation fault

Since the example code, when executed, generates a segmentation fault, GDB can be used to inspect the problem.

 $ gdb ./example
GNU gdb (GDB) Fedora (7.3.50.20110722-13.fc16) Copyright (C) 2011 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. Type "show copying" and "show warranty" for details. This GDB was configured as "x86_64-redhat-linux-gnu". For bug reporting instructions, please see: ... Reading symbols from /path/example...done. (gdb) run Starting program: /path/example Program received signal SIGSEGV, Segmentation fault. 0x0000000000400527 in foo_len (s=0x0) at example.c:8 8 return strlen (s); (gdb) print s $1 = 0x0

The problem is present in line 8, and occurs when calling the function strlen (because its argument, s, is NULL). Depending on the implementation of strlen (in-line or not), the output can be different, e.g.:

GNU gdb (GDB) 7.3.1 Copyright (C) 2011 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. Type "show copying" and "show warranty" for details. This GDB was configured as "i686-pc-linux-gnu". For bug reporting instructions, please see: ... Reading symbols from /tmp/gdb/example...done. (gdb) run Starting program: /tmp/gdb/example Program received signal SIGSEGV, Segmentation fault. 0xb7ee94f3 in strlen () from /lib/i686/cmov/libc.so.6 (gdb) bt #0 0xb7ee94f3 in strlen () from /lib/i686/cmov/libc.so.6 #1 0x08048435 in foo_len (s=0x0) at example.c:8 #2 0x0804845a in main (argc=, argv=) at example.c:16

To fix the problem, the variable a (in the function main) must contain a valid string. Here is a fixed version of the code:

#include 
#include 
#include 

size_t foo_len (const char *s)
{
  return strlen (s);
}

int main (int argc, char *argv[])
{
  const char *a = "This is a test string";

  printf ("size of a = %d\n", foo_len (a));

  exit (0);
}

Recompiling and running the executable again inside GDB now gives a correct result:

GNU gdb (GDB) Fedora (7.3.50.20110722-13.fc16) Copyright (C) 2011 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. Type "show copying" and "show warranty" for details. This GDB was configured as "x86_64-redhat-linux-gnu". For bug reporting instructions, please see: ... Reading symbols from /path/example...done. (gdb) run Starting program: /path/example size of a = 21 [Inferior 1 (process 14290) exited normally]

GDB prints the output of printf in the screen, and then informs the user that the program exited normally.

See also

References

  1. ^ "GDB Documentation - Supported Languages". Retrieved 2011-11-28. 
  2. ^ "GDB Documentation - Summary". Retrieved 2011-11-28. 
  3. ^ a b "Richard Stallman lecture at the Royal Institute of Technology, Sweden (1986-10-30)". Retrieved 2006-09-21. Then after GNU Emacs was reasonably stable, which took all in all about a year and a half, I started getting back to other parts of the system. I developed a debugger which I called GDB which is a symbolic debugger for C code, which recently entered distribution. Now this debugger is to a large extent in the spirit of DBX, which is a debugger that comes with Berkeley Unix. 
  4. ^ "GDB Steering Committee". Retrieved 2008-05-11. 
  5. ^ "GDB News". Gnu.org. Retrieved 2013-07-17. 
  6. ^ "GDB Documentation - Summary - Contributors". Retrieved 2011-12-01. 
  7. ^ "GDB 7.0 Release Notes". Retrieved 2011-11-28. 
  8. ^ Joel Brobecker (2014-07-29). "GDB 7.8 released!". Retrieved 2014-07-40. 
  9. ^ "Reverse Debugging with GDB". Retrieved 2014-01-20. 
  10. ^ "Howto: GDB Remote Serial Protocol: Writing a RSP Server". 
  11. ^ "Implementing a remote stub". 
  12. ^ "Kernel debugging with Dcons". 

External links

  • Official website
  • KGDB: Linux Kernel Source Level Debugger
  • MyGDB: GDB Frontend web site which is In Korean language
  • A Visual Studio plugin for debugging with GDB
  • Comparison of GDB front-ends, 2013
  • Using Eclipse as a Front-End to GDB Debugger

Documentation

Tutorials

  • Peter Jay Salzman's GDB guide: Using The GNU GDB Debugger (Peter Jay Salzman)
  • RMS's gdb Tutorial (Ryan Schmidt)
This article was sourced from Creative Commons Attribution-ShareAlike License; additional terms may apply. World Heritage Encyclopedia content is assembled from numerous content providers, Open Access Publishing, and in compliance with The Fair Access to Science and Technology Research Act (FASTR), Wikimedia Foundation, Inc., Public Library of Science, The Encyclopedia of Life, Open Book Publishers (OBP), PubMed, U.S. National Library of Medicine, National Center for Biotechnology Information, U.S. National Library of Medicine, National Institutes of Health (NIH), U.S. Department of Health & Human Services, and USA.gov, which sources content from all federal, state, local, tribal, and territorial government publication portals (.gov, .mil, .edu). Funding for USA.gov and content contributors is made possible from the U.S. Congress, E-Government Act of 2002.
 
Crowd sourced content that is contributed to World Heritage Encyclopedia is peer reviewed and edited by our editorial staff to ensure quality scholarly research articles.
 
By using this site, you agree to the Terms of Use and Privacy Policy. World Heritage Encyclopedia™ is a registered trademark of the World Public Library Association, a non-profit organization.
 


Copyright © World Library Foundation. All rights reserved. eBooks from Project Gutenberg are sponsored by the World Library Foundation,
a 501c(4) Member's Support Non-Profit Organization, and is NOT affiliated with any governmental agency or department.