tool-gdb

Connects z88dk-gdb to gdbserver targets for source-level debugging of Z80 programs.

1.1k|206|Updated Mar 16, 2016
One-click install
npx skills add https://github.com/z88dk/z88dk --skill tool-gdb-z88dk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-gdb
Source: https://github.com/z88dk/z88dk/tree/main/.agents/skills/tool-gdb
Command: npx skills add https://github.com/z88dk/z88dk --skill tool-gdb-z88dk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging Z80 and 8080 programs built with z88dk often requires more than cycle counting; developers need interactive, source-level debugging against emulators or hardware. This Skill guides the use of z88dk-gdb, the GDB client that connects to a compatible gdbserver with symbol files. ## Core Features & Use Cases - Remote debugging over TCP: Connect to a gdbserver host and port with -h and -p, loading one or more symbol files via -x. - Direct device debugging: Attach to a hardware device with -d for on-target source-level debugging. - Tool selection guidance: Helps decide when to use z88dk-gdb versus z88dk-ticks, since cycle counts and hotspot histograms are better handled by ticks. - Use Case: You are debugging a C program compiled for a ZX Spectrum target in the FUSE emulator. Start FUSE's gdbserver, then run z88dk-gdb with the host, port, and your generated symbol file to step through source lines and inspect state. ## Quick Start Ask the assistant to connect z88dk-gdb to your emulator's gdbserver on a given host and port using your compiled symbol file to begin source-level debugging.

Frequently Asked Questions about tool-gdb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a z88dk program with gdb?

Use z88dk-gdb to connect to a gdbserver with the -h host and -p port flags, passing your debug symbols via -x. Alternatively, attach directly to a hardware device with -d. Multiple -x symbol files are supported.

What is the difference between z88dk-gdb and z88dk-ticks?

z88dk-gdb provides interactive source-level debugging against a remote gdbserver, while z88dk-ticks runs locally for cycle counts, PC histograms, and hotspot analysis. Use ticks for measurement and z88dk-gdb for interactive debugging sessions.

Which emulators work with z88dk-gdb?

z88dk-gdb connects to any compatible gdbserver, including emulators such as MAME and FUSE, as well as hardware targets. Check the z88dk wiki for the current list of compatible gdb servers and confirm against your emulator version.

Can I load multiple symbol files in z88dk-gdb?

Yes, z88dk-gdb accepts more than one -x flag, each specifying a debug symbol file. This is useful when your program is split across multiple modules or libraries that each produce their own symbols.

When should I not use z88dk-gdb for Z80 debugging?

Avoid z88dk-gdb when you only need cycle counts or hotspot histograms on a linked binary, since z88dk-ticks handles those locally without a remote server. Also verify symbol linkage with z80nm and the map file before debugging.