Can this skill help with stack pointer (RSP) corruption?

Yes, it includes specific configurations for hardware watchpoints and conditional breaks to detect when the stack pointer moves outside of valid kernel stack ranges.

How does it compare register states?

The skill defines custom GDB macros like 'snap-regs' to capture the current state and 'diff-regs' to automatically highlight exactly which registers changed between two execution points.

Do I need QEMU to use this skill?

Yes, the skill is designed to work with the Breenix kernel running in QEMU with the GDB server enabled (BREENIX_GDB=1) for remote debugging sessions.

What is the main purpose of the Breenix Register Watch skill?

It provides a structured GDB-based framework for identifying and fixing register corruption within the Breenix operating system kernel, particularly during context switches.

Breenix Register Watch

Name: Breenix Register Watch
Author: ryanbreen

byryanbreen

•

Security & Testing

Provides a systematic framework for debugging register corruption and context switch issues within the Breenix kernel using GDB.

Breenix Register Watch is a specialized debugging tool designed for kernel developers to track and resolve register corruption issues. It automates the process of capturing and comparing register states (GPRs) across critical kernel boundaries like context switches, syscall entries, and interrupt handlers. By providing pre-defined GDB commands for snapshots and delta analysis, it enables developers to pinpoint exactly where registers like RSP or RAX are being clobbered, facilitating faster resolution of system crashes and stack pointer errors.

Key Features

01Automated register snapshotting and comparison using snap-regs and diff-regs commands

02Hardware watchpoint configurations for tracking stack pointer (RSP) corruption

03Pre-configured breakpoints for context switches, syscall handlers, and timer interrupts

044 GitHub stars

05Conditional debugging patterns for identifying invalid register states and memory ranges

06Systematic workflow for validating kernel register preservation and fixing assembly clobbers

Use Cases

01Investigating userspace process crashes resulting from improper context restoration logic

02Identifying register clobbering in inline assembly within the Breenix kernel

03Debugging kernel panics caused by stack pointer (RSP) corruption during hardware interrupts

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ryanbreen/breenix breenix-register-watch

For use in Claude.ai and ChatGPT

Download Skill