gdbstub.h File Reference

GDB Stub definition for remote debugging userspace processes. More...

#include <libcommon/string.h>
#include <console/serial.h>
#include <processes/process.h>
#include <hardwarecommunication/interrupts.h>

Go to the source code of this file.

Classes
class	MaxOS::runtime::TrapFlagExcpetion
	Exception handler for a hardware mem watch. More...
class	MaxOS::runtime::BreakPointException
	Exception handler for a hardware breakpoint. More...
class	MaxOS::runtime::GDBServer
	Handler for running a GDB server over serial. More...

Variables
constexpr bool	MaxOS::runtime::DO_DEBUGGING = false
	Whether to use the serial for GDB communcation or for logging.
constexpr char *	MaxOS::runtime::DEBUG_TARGET = "DriverManager.elf"
	The userspace process to attach to.

Detailed Description

GDB Stub definition for remote debugging userspace processes.

See also

https://www.chciken.com/tlmboy/2022/04/03/gdb-z80.html - Adapted from here, very helpful

Todo:

almost zero validation going on

Date

3rd April 2026

Author

Max Tyson

Definition in file gdbstub.h.

Variable Documentation

DEBUG_TARGET

constexpr char* MaxOS::runtime::DEBUG_TARGET = "DriverManager.elf"

constexpr

The userspace process to attach to.

Definition at line 29 of file gdbstub.h.

Referenced by MaxOS::processes::GlobalScheduler::add_process().

DO_DEBUGGING

constexpr bool MaxOS::runtime::DO_DEBUGGING = false

constexpr

Whether to use the serial for GDB communcation or for logging.

Definition at line 26 of file gdbstub.h.

Referenced by MaxOS::processes::GlobalScheduler::add_process(), and MaxOS::console::SerialConsole::SerialConsole().