# debugger-utils

**Repository Path**: supertom-spec/debugger-utils

## Basic Information

- **Project Name**: debugger-utils
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-02-22
- **Last Updated**: 2021-11-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Utilities for extending gdb with python

## Usage

1. Download `debugger-utils` to directory `X`
2. Put these to your `~/.gdbinit`:
```
python import sys; sys.path.append('$X/debugger-utils')
```
`$X` is where `debugger-utils` lies in.
3. `import gdb_utils` in your python script.

## Example

```python
# Create a gdb commands in hello.py
import gdb_utils


def hello(who, *args):
    """
    Say hello.
    """
    print('hello %s', who)
gdb_utils.define(hello)
#(gdb) so hello.py
#(gdb) hello 'world'
```

For more examples, see [example](./example).

## API

GDB commands:

- [x] break
- [x] clear
- [x] commands
- [x] delete
- [x] disable
- [x] define
- [x] enable
- [x] info
- [x] thread
- [x] thread_name
- [x] watch

Other API:

- [x] get_breakpoint
- [x] function
- [x] stop
- [x] register_pprinter
- [x] build_pprinter
- [x] globval
- [x] ty

For more info, see [API.md](./API.md).