Using GDB for Linux Applications

Debugging is an essential part of software development. For debugging applications on Linux, the GNU Project Debugger (GDB) is one of the most powerful ...

and versatile tools available. This blog post covers using GDB to debug Linux applications and explains its features, steps, and best practices.


# 1. Introduction to GDB

GDB, or GNU Debugger, is a powerful debugging tool for Linux applications written in C, C++, Fortran, and others. It allows developers to step through code, set breakpoints, inspect variables, and monitor program execution. GDB runs on various platforms including Linux, Windows, and macOS. For this guide, we will focus on its usage with Linux applications.

---

1. Setting Up GDB
2. Basic Commands
3. Advanced Features
4. Common Debugging Scenarios
5. Best Practices
6. Conclusion

---

1.) Setting Up GDB

To start using GDB, you need to have the debugger installed on your system. On a Debian-based system like Ubuntu, you can install it using:

sudo apt-get update
sudo apt-get install gdb

For other distributions, you might use a package manager such as `yum` or `pacman`. Once installed, you can start GDB by running:

gdb [executable]

Replace `[executable]` with the path to your Linux application.

---

2.) Basic Commands

Starting and Stopping Debugging

- Start GDB: `gdb [executable]`

- Run the program: `run` or `r`

- Quit GDB: `quit` or `q`

Setting Breakpoints

Breakpoints can be set at specific lines in your code:

break main  # Set breakpoint at entry point of the program
break filename:linenum  # Set breakpoint in a specific file

To see all breakpoints, use:

info breakpoints

Running and Stepping Through Code

- Continue execution: `continue` or `c`

- Step over next function call: `next` or `n`

- Step into the next function: `step` or `s`

Inspecting Variables

Use commands like:

print variable  # Print value of a variable
backtrace  # Show call stack
info locals  # List local variables

---

3.) Advanced Features

Conditional Breakpoints

You can set breakpoints that only trigger when a certain condition is met:

break main if condition

For example, to break when `x` equals 5:

break main if x == 5

Watching Variables

Watches allow you to monitor changes in variable values:

watch variable

This will pause execution whenever the value of the watched variable changes.

Examining Memory

Use `x` command to examine memory contents:

x/nfu address  # Examine n units of size f starting at address

For example, to see 5 ints starting from address 0x1234:

x/5i 0x1234

---

4.) Common Debugging Scenarios

Finding Memory Leaks

Use `valgrind` in combination with GDB for memory leak detection:

valgrind --tool=memcheck --leak-check=full gdb [executable]

In the GDB prompt, run:

run

Debugging Multi-threaded Applications

Use `info threads` to list all threads and switch between them using `thread`:

info threads
thread [id]  # Switch to thread with specified ID

---

5.) Best Practices

Automating Commands with Scripts

You can write GDB scripts (Python, Python3) to automate repetitive tasks or create custom commands:

define my_command
commands
...  # Your command code here
end
enddef
my_command

Using Configuration Files

Save your frequently used GDB commands in a configuration file and source it using:

source [configfile]

Learning Resources

- Official Documentation: The official GDB documentation is available online.

- Online Tutorials: Websites like `gdbguide.com` offer tutorials and examples.

- Books: -Debugging Applications- by Greg Haskins or -UNIX and Linux System Administration Handbook- by Evi Nemeth, Garth Snyder, Trent Raine, and Ben Whaley can be helpful.

---

6.) Conclusion

GDB is a powerful debugging tool that becomes indispensable when dealing with complex applications running on Linux systems. By understanding its basic commands and exploring advanced features, you can efficiently debug your applications, pinpoint issues, and optimize performance. Whether you are a seasoned developer or just starting in the world of system programming, mastering GDB will undoubtedly enhance your development workflow.

Remember to always combine theoretical knowledge with practical application to fully harness the capabilities of GDB. Happy debugging!

---

The Autor: Doomscroll / Jamal 2025-11-15