gdb-attach
CommunityKernel-level debugging from assembly to C using GDB.
Authorryanbreen
Version1.0.0
Installs0
System Documentation
What problem does it solve?
It enables detailed debugging of Breenix at the assembly and C level, including interrupt and boot sequence analysis, by connecting GDB to a running QEMU instance.
Core Features & Use Cases
- Breakpointing at boot-time and during initialization
- Inspect registers, memory, and control-flow
- Step through boot, interrupt entry, and context-switch paths
- Use cases: diagnose early boot issues or kernel exceptions by attaching GDB and stepping
Quick Start
Launch QEMU in GDB mode: BREENIX_GDB=1 cargo run --release --bin qemu-uefi Then connect with: gdb target/x86_64-breenix/release/kernel -ex 'target remote localhost:1234' Or use the helper: breenix-gdb-attach/scripts/connect.py (if present) - optional.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: gdb-attach Download link: https://github.com/ryanbreen/breenix/archive/main.zip#gdb-attach Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.