Depurar con GDB

Una de las tareas que cualquier progamador debe realizar a menudo es depurar el código. Vamos a aprender a depurar con GDB nuestros programas de C++, para ello utilizaremos un sencillo programa de Hola Mundo como ejemplo. Si no tienes uno preparado puedes utilizar el que se muestra en el tutorial de CMAKE.

Preparación

Edita o crea un archivo hello.cpp para que quede tal que así:

#include <iostream>

int main()
{
  int x = 10;
  x += 2;
  std::cout << "Hello word! x = " << x << std::endl;
  
  return 0;
}
  

Asegúrate de que funciona mediante make.

Ejecutando GDB

Una vez que estamos seguros de que el programa funciona perfectamente procedemos a depurarlo mediante gdb. Para ello escribe gdb hello en la consola, lo que produce la siguiente salida:

GNU gdb (Ubuntu 9.2-0ubuntu1~20.04.1) 9.2
Copyright (C) 2020 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
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-linux-gnu".
Type "show configuration" for configuration details.
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Find the GDB manual and other documentation resources online at:
    <http://www.gnu.org/software/gdb/documentation/>.

For help, type "help".
Type "apropos word" to search for commands related to "word"...
Reading symbols from hello...
(No debugging symbols found in hello)
(gdb)

Como puedes ver, la salida del programa nos indica que no hay símbolos de depuración para poder proceder, así que vamos a comunicarlos al compilador durante el propio paso de compilación. Antes de nada sal de la sesión de compilación simplemente escribiendo q y pulsando Enter. Edita el archivo makefile para añadir la opción -g en la sección del compilador (sección hello.o):

CC = g++
all: hello
hello: hello.o
	${CC} -o hello hello.o
hello.o: hello.cpp
	${CC} -c -g hello.cpp
clean:
	rm hello.o hello

Ahora tenemos que establecer un punto de ruptura para detener la ejecución en ese punto. Para ello entramos al modo depuración, como ya hicimos antes, mediante:

gdb hello

Comandos comunes

Una vez dentro de la sesión de depuración, teclea b 5 para establecer un punto de ruptura en la línea 5.

(gdb) b 5
Breakpoint 1 at 0x11d5: file hello.cpp, line 5.

Con esto ya estaríamos listos para ejecutar de nuevo el programa. Para ello introducimos el comando r y pulsamos Enter. En este momento el programa se ejecutará con nuestro punto de ruptura correctamente establecido.

Starting program: /home/jflores/CLionProjects/cplusplus/hello

Vemos como el proceso indica que se ha detenido en la línea 5:

Breakpoint 1, main () at hello.cpp:5
5               int x = 10;

Para proceder paso a paso a partir de aquí, introducimos el comando n, equivalente a next step. Otro comando útil es s, que significa step into, para continuar dentro del paso actual (útil si estamos detenidos sobre una función, por ejemplo).

6               x += 2;

Si tenemos que conocer el contenido de una variable podemos ejecutar el comando p, que significa imprimir:

$1 = 10

Se puede continuar la ejecución del programa hasta el final, o bien hasta el próximo punto de ruptura, mediante el comando c (significa continuar).

(gdb) c
Continuing.
Hello word! x = 12
[Inferior 1 (process 423538) exited normally]

Puedes encontrar más información sobre GDB en la página oficial del proyecto (en inglés).