Skip to content

GDB basics - merging bot articles #71

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jeremy-rifkin merged 4 commits into from
Jan 27, 2026
Merged

GDB basics - merging bot articles #71

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
d90f22d
GDB basics - merging bot articles https://github.com/TCCPP/wiki/issue…
ProfessionalMenace Jan 26, 2026
2fcee42
whitespace fix
ProfessionalMenace Jan 26, 2026
3bf3a86
Merge branch 'TCCPP:main' into gdb-merge
ProfessionalMenace Jan 26, 2026
8da801e
removed see also articles from bot command
ProfessionalMenace Jan 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 0 additions & 45 deletions bot-articles/gdb.md
View file
Open in desktop

This file was deleted.

21 changes: 12 additions & 9 deletions wiki/cpp-tutorial/debugging-gdb.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,15 @@
bot_article: |
# GNU Debugger (GDB)

Compile with debug symbols: `g++ main.cpp -o prog -Og -g`
Compile with debug symbols: `g++ main.cpp -o program -Og -g`

**Quick reference:**
- `gdb prog` - Launch debugger
- `break 10` / `b main` - Set breakpoint
- `gdb program` - Launch debugger (`--tui` for terminal user interface mode)
- `break 10` / `b main` - Set a breakpoint at a certain line / function
- `info b` - List all active breakpoints
- `run` / `start` - Start execution
- `next` / `step` - Step over / into
- `next` - Step over (next stays in the function)
- `step` - Step into (step goes inside calls)
- `print var` - Inspect variable
- `backtrace` - Show call stack
- `continue` - Resume to next breakpoint
Expand All @@ -21,14 +23,15 @@ The GNU Debugger (GDB) is one of the most widely used debuggers today, with nume
GDB is freely available under the GPLv3 license.

- [See the official documentation](https://www.sourceware.org/gdb/documentation/)
- [See a TCCPP video tutorial](https://www.youtube.com/watch?v=bSEW0BvMiGc)
- [See a TCCPPCon#1: Debugging with GDB](https://www.youtube.com/watch?v=bSEW0BvMiGc)
- [How to Debug Using GDB](https://cs.baylor.edu/~donahoo/tools/gdb/tutorial.html)

## GDB Quickstart

### Create an executable with debug symbols

```bash
g++ main.cpp -o executable.file -Og -g
g++ main.cpp -o program -Og -g
```

- `-O0` - enables no optimizations (maybe preferred)
Expand All @@ -50,15 +53,15 @@ GDB is self documented.
### Launch a debugger with a file attached

```bash
gdb executable.file
gdb program
```

- GNU debugger `gdb`
- Executable `executable.file` you want to inspect
- Executable `program` you want to inspect

### Layouts `layout, lay`

- Launch TUI directly `gdb executable.file --tui` (equivalent to `layout src`)
- Launch TUI directly `gdb program --tui` (equivalent to `layout src`)
- Layout source `layout src` - displays source code (if not available recompile with `-g` flag enabled)
- Layout assembly `layout asm` - displays assembly
- Layout split `layout split` - displays both assembly and source layout
Expand Down