gdb-attach

Community

Kernel-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 required

Components

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.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.