CYGDB(1)

💅 CYGDB(1) — the cygdb manual, bestie edition ✨

User Commands · run compiled Cython code under the GNU debugger 🐛💖

---

🎀 NAME 🎀

cygdb — ok so this is the girl who runs your compiled Cython code under the GNU debugger. She's giving debugger-but-make-it-Cython. Slay.

---

🌸 DESCRIPTION 🌸

Bestie. The way that this tool exists at all is iconic. Here's the literal usage, don't come for me:

usage: cygdb [-h] [--build-dir BUILD_DIR] [--gdb-executable GDB] [--verbose]
             [--skip-interpreter] [gdb_argv ...]

Cython debugger 🐛✨

That's the whole vibe. It's a debugger, but it knows about your Cython. Periodt.

---

🫶 positional arguments 🫶

• gdb_argv — the arguments you wanna forward to gdb; you gotta put them after -- so nobody gets confused 💫

---

👑 options 👑

• -h, --help — shows this help message and then dips. exit. bye. 😌
• --build-dir BUILD_DIR — the directory that's holding your cython_build/ files 📁
• --gdb-executable GDB — which gdb executable to use. default is gdb, no cap. 🌈
• --verbose, -v — verbose mode, babes. and like, multiple -v options stack — the more you add, the more verbosity you get 🔥
• --skip-interpreter — do not automatically point GDB at the same interpreter that was used to generate the debugging information 🙈

ngl that last one matters if you don't want GDB grabbing the same interpreter as your debug info came from — it's a whole choice, and now it's your choice 💅

---

💜 SEE ALSO 💜

(there's no SEE ALSO section in this one, bestie — she's a standalone queen, no cross-references, no nothing, just vibes) 🦋

---

Cython 3.1.6 · March 2026 — that's the version and the date, mwah 💋

and that's the whole CYGDB(1) page, bestie 🫶 go forth and debug your Cython like the main character you are ⭐🧚💖