How do I connect GDB to the Breenix kernel?

Start QEMU with the BREENIX_GDB=1 flag, then use the 'breenix-connect' command within GDB or the provided target remote command to attach to the localhost:1234 GDB server.

How can I inspect page tables using this skill?

The skill guides you to read the $cr3 register and use GDB memory examination commands (x/4xg) to manually walk the PML4 and subsequent table levels.

What architecture does this skill support?

The Breenix-GDB-Attach skill is optimized for x86_64 architecture, specifically focusing on UEFI-based Breenix kernel development.

Can I debug the early boot sequence?

Yes, this skill provides instructions for using hardware breakpoints (hbreak) which allow you to step through initialization code before paging is fully established.

Does this support debugging syscalls?

Yes, it includes specific scenarios for breaking on rust_syscall_handler and inspecting registers like %rax and %rdi to analyze syscall numbers and arguments.

Breenix GDB Debugger

Name: Breenix GDB Debugger
Author: ryanbreen

byryanbreen

•

安全与测试

Facilitates low-level kernel debugging for Breenix using GDB and QEMU to inspect hardware states, memory layouts, and execution flow.

The Breenix GDB Attach skill provides a specialized toolkit for developers working on the Breenix kernel, enabling deep-dive debugging at the assembly and C-levels. It streamlines the process of connecting GDB to a running QEMU instance, allowing for precise investigation of CPU exceptions, page faults, and context switches. By providing specialized commands for register inspection, memory mapping, and syscall analysis, this skill bridges the gap between high-level development and low-level hardware interaction, making kernel-level troubleshooting more efficient and structured for developers building operating systems.

主要功能

01Real-time inspection of x86_64 registers and page table structures

02Trace-level debugging for syscalls, interrupts, and context switches

03Integration with Breenix-specific GDB helper commands

04Advanced breakpoint management for kernel-level entry points

054 GitHub stars

06Automated QEMU-GDB connection configuration and setup

使用场景

01Investigating complex kernel-level page faults and triple faults

02Analyzing CPU register states during interrupt handling and transitions

03Stepping through the early boot sequence and system initialization

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ryanbreen/breenix breenix-gdb-attach

For use in Claude.ai and ChatGPT

Download Skill