https://github.com/slamko/gdb-debug-until
GDB extension for event-based debugging
https://github.com/slamko/gdb-debug-until
debugging event-driven gdb-commands python-gdb
Last synced: 5 months ago
JSON representation
GDB extension for event-based debugging
- Host: GitHub
- URL: https://github.com/slamko/gdb-debug-until
- Owner: slamko
- License: gpl-3.0
- Created: 2022-01-19T16:55:42.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-05-10T20:08:57.000Z (about 3 years ago)
- Last Synced: 2024-11-20T19:36:12.021Z (7 months ago)
- Topics: debugging, event-driven, gdb-commands, python-gdb
- Language: Python
- Homepage:
- Size: 66.4 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GDB extension for event-based debugging
---
## The idea
It is common task to debug someone other's code, and it could be quite complicated to catch the moment, when something goes wrong, by looking through the code that you don't understand, especially if there are no comments. So this little extension with a couple of pyhton scripts and embedded Python interpretor in GDB may enhance your debugging experience. The idea is to specify the behaviour that, as you expect, will be triggered during the program is running, and ```debug-until``` will run through the code, until the specified event will be triggered, so a pretty-formatted message will be printed on the screen.
## Getting started
For a quick start you can clone this repo into your current working directory:
```
git clone https://github.com/Viaceslavus/gdb-debug-until.git
```
And run the following gdb command:
```
source gdb-debug-until/debug_until.py
```
To make this extension running every time GDB does, you can add the last command into the ```.gdbinit``` file located in your home directory (if you are on Linux),
specifying the correct path to the python script.
## Usage:
```
debug-until [options] [event]
- should be passed in the format that is accepted by GDB
(e.g. : or )
Options:
--args= : arguments to be passed to GDB`s "run" command
--step-in : by default debug-until uses the GDB`s "next" command
to iterate through your code.
Add this option to switch from "next" to "step" command
-r= : number of times the program should be executed
-i : iterate through assembly code by instruction.
Events
--cmp= && --exp= (Should be used together)
: - the shell command that will be executed after each line of code
The output of the will be compared with an
--file-created= : run until the specified file created
--file-deleted= : run until the specified file created
--var-eq=: : run until the value of variable equals
--end= : run until end brakpoint
```
##### * run ```debug-until --help``` to get usage info in the terminal.
## Example:
if you want to catch the moment when some variable in your code will have a specific value, you can simply run:
```
debug-until main --args="" --var-eq="my_var:10"
```
inside GDB.
So, the command above will create a breakpoint in 'main' function, run the inferior program without arguments and wait until the variable, called 'my_var', will contain value 10. 'Debug-until' will iterate through each line of your code and report to you, when the condition will return true.
Some more examples can be found at [examples.md](https://github.com/Viaceslavus/gdb-debug-until/blob/master/examples.md)