How to Debug C Programs in Linux using gdb

No matter how experienced you are as a programmer, any software you develop cannot be completely free of bugs. That's why identifying bugs and fixing them is one of the most important tasks in the software development cycle. While there are many ways to find bugs (testing, self-checking code, etc.), there is also special software - called debuggers - that helps you understand exactly where the problem is so you can easily fix it.

Assuming you are a C/C++ programmer or develop software using the Fortran and Modula-2 programming languages, in this case you will be glad to know that there is an excellent debugger - called GDB - that you can use to easily check your code for errors and other problems. In this article we will discuss the basics of GDB and some of its useful features/options.

GDB debugger basics

In layman's terms, GDB lets you peek inside a program while the program is executing, something that lets you help identify where exactly the problem is. We'll discuss the usage of the GDB debugger through a working example in the next section, but before that, here, we'll discuss a few basic points that'll help you later on.

Firstly, to successfully use debuggers like GDB, you have to compile your program so that the compiler also produces debugging information that debuggers require. For example, in case of the gcc compiler, which we'll be using to compile the example C program later in this tutorial, you need to use the -g command line option while compiling your code.

To know what the gcc compiler's manual page says about this command line option, head here.

Next step is to make sure that you have GDB installed on your system. If that's not the case, and you're on a Debian-based system like Ubuntu, you can easily install the tool using the following command:

sudo apt install gdb

For installation on any other distro, head here.

Now, once you've compiled your program in a way that it's debugging-ready, and GDB is there on your system, you can execute your program in debugging mode using the following command:

gdb [prog-executable-name]

While this will initiate the GDB debugger, your program executable won't be launched at this point. This is the time when you can define your debugging-related settings. For example, you can define a breakpoint that tells GDB to pause the program execution at a particular line number or function.

Moving on, to launch your program, you'll have to execute the following gdb command:


It's worth mentioning that if your program requires some command line arguments to be passed, you can specify them here. For example:

run [arguments]

GDB provides many useful commands that come in handy while debugging. We'll discuss some of them in the example in next section.

GDB usage example

Now we have a basic idea about GDB as well as its usage. So let's take an example and apply the knowledge there. Here's an example code:

#include <stdio.h>

int main()
int out = 0, tot = 0, cnt = 0;
int val[] = {5, 54, 76, 91, 35, 27, 45, 15, 99, 0};

while(cnt < 10)
out = val[cnt];
tot = tot + 0xffffffff/out;

printf("\n Total = [%d]\n", tot);
return 0;

So basically, what this code does is, it picks each value contained in the 'val' array, assigns it to the 'out' integer, and then calculates 'tot' by summing up the variable's previous value and the result of '0xffffffff/out.'

The problem here is that when the code is run, it produces the following error:

$ ./gdb-test 
Floating point exception (core dumped)

So, to debug the code, the first step would be to compile the program with -g. Here's the command:

gcc -g -Wall gdb-test.c -o gdb-test

Next up, let's run GDB and let it know which executable we want to debug. Here's the command for that:

gdb ./gdb-test 

Now, the error I am getting is 'floating point exception,' and as most of you might already know, it's caused by n % x, when x is 0. So, with that in mind, I put a break point at line number 11, where the division is taking place. This was done in the following way:

(gdb) break 11

Note that '(gdb)' is the debugger's prompt. I just wrote the 'break' command.

Now, I asked GDB to start the execution of the program:


So, when the breakpoint was hit for the first time, here's what GDB showed in the output:

Breakpoint 1, main () at gdb-test.c:11
11 tot = tot + 0xffffffff/out;

As you can see in the output above, the debugger showed the line where the breakpoint was put. Now, let's print the current value of 'out.' This can be done in the following way:

(gdb) print out
$1 = 5

As you can see that the value '5' was printed. So, things are fine at the moment. I asked the debugger to continue the execution of the program until the next breakpoint, something which can be done using the 'c' command.


I kept on doing this work, until I saw that the value of 'out' was zero.

Breakpoint 1, main () at gdb-test.c:11
11 tot = tot + 0xffffffff/out;
(gdb) print out
$2 = 99
(gdb) c

Breakpoint 1, main () at gdb-test.c:11
11 tot = tot + 0xffffffff/out;
(gdb) print out
$3 = 0

Now, to confirm this is the exact problem, I used GDB's 's' (or 'step') command instead of 'c' this time. I just wanted line 11, where the program execution currently stands paused, to execute, and see if crash occurs at this point.

Here's what happened:

(gdb) s

Program received signal SIGFPE, Arithmetic exception.
0x080484aa in main () at gdb-test.c:11
11 tot = tot + 0xffffffff/out;

Yes, as confirmed by the highlighted output above, this is where the exception was thrown. The final confirmation came when I tried running the 's' command once again:

(gdb) s 

Program terminated with signal SIGFPE, Arithmetic exception.
The program no longer exists.

So this way, you can debug your programs using GDB.


We've just scratched the surface here, as GDB offers many features for users to explore and use. Go through the man page of GDB to learn more about the tool, and try using it whenever you're debugging something in your code. The debugger has a bit of a learning curve, but it's worth the hard work.

Share this page:

Suggested articles

1 Comment(s)

Add comment


By: Jonathas at: 2021-03-13 05:16:01

Excellent tutorial.