cuda-gdb-plus

KO | EN

gitlite — search

#ai #typescript #golang #machine-learning #rust #linux #java #windows #awesome #vue #awesome-list #security #openai #mcp

(★ 11)

A context dashboard for cuda-gdb (and plain gdb)

cuda-gdb-plus 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# cuda-gdb++

A [PEDA](https://github.com/longld/peda)-inspired context dashboard for `cuda-gdb` (and plain `gdb`).
It prints structured stop-time panels for host and device debugging without patching the debugger.

---

## Install

```bash
git clone https://github.com/stefan1wan/cuda-gdb-plus ~/cuda-gdb++
echo "source ~/cuda-gdb++/cuda-gdb-plus.py" >> ~/.cuda-gdbinit
echo "[DONE] Debug your program with cuda-gdb and enjoy!"
```

If you use plain `gdb`, replace `.cuda-gdbinit` with `.gdbinit`.

Python support:
- Requires Python 3 (tested with the Python runtime embedded in `cuda-gdb` 13.x)

---

## Quick Start

```bash
cd examples/vector_add
make
cuda-gdb ./vector_add
```

```gdb
(cuda-gdb) break device_scale
(cuda-gdb) run
(cuda-gdb) stepi
(cuda-gdb) plus gpu
(cuda-gdb) plus help
```

### Tested Environments

- CUDA: 12.8, 13.0
- Host OS: Ubuntu 22.04 (AArch64), Ubuntu 24.04 (x86_64)
- GPU: NVIDIA GB10, NVIDIA GeForce RTX 3060

---

## Dashboard

![alt text](https://raw.githubusercontent.com/stefan1wan/cuda-gdb-plus/main/dashboard.png)
---

## Commands

| Command | Description |
|---|---|
| `plus context` | Redraw dashboard now |
| `plus gpu [mode]` | Merged CUDA inspector: `gpu`, `lanes`, `threads [filter]`, `kernels`, `trace` |
| `plus stack` | Verbose stack output (`bt full` + `info frame`) |
| `plus telescope [addr] [n]` | Dereference chain at address (e.g., `plus telescope 0x7fffd7270a40 8`; default `$sp` `8`) |
| `plus fault` | Summarize divergence, lane exceptions, and barrier state for current CUDA focus |
| `plus aslr [on\|off]` | Show or toggle ASLR |
| `plus checksec` | NX / PIE / canary / ASLR / RELRO summary |
| `plus vmmap [filter]` | Process memory map (`/proc/pid/maps`) |
| `plus canary` | Show stack canary value |
| `plus help` | Compact command reference |

---

## Tunables

| Variable | Default | Effect |
|---|---|---|
| `WIDTH` | `72` | Divider width |
| `REG_COLS` | `4` | Registers per row |
| `REG_COL_W` | `28` | Register cell width |
| `CODE_BEFORE` | `4` | Instructions shown above current PC |
| `CODE_AFTER` | `6` | Instructions shown below current PC |
| `SOURCE_CONTEXT` | `5` | Source lines around current line |
| `STACK_MEM_WORDS` | `8` | Host stack telescope depth |
| `CLEAR_SCREEN` | `False` | Clear terminal before each dashboard draw |

---

## Citation

If you use this project in research, please cite:

```bibtex
@software{wan_cuda_gdb_plus_2026,
  author       = {Wan, Junpeng},
  title        = {cuda-gdb++: Enhanced CUDA Debugging Tools},
  year         = {2026},
  url          = {https://github.com/stefan1wan/cuda-gdb-plus},
  license      = {MIT},
  note         = {Developed with assistance from Claude Code and Codex.}
}
```

A machine-readable citation file is provided in [`CITATION.cff`](CITATION.cff).

---

## License

cuda-gdb-plus

cuda-gdb-plus 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

cuda-gdb-plus

cuda-gdb-plus 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README