This is an old revision of the document!
====== Stefan Hajnoczi: GDB Remote Debugging ====== ===== Project Plan ===== ==== Summary ==== This project will enable gPXE debugging using the GDB remote target feature. Developers will be able to inspect gPXE from a remote machine and control its execution. Only 32-bit protected mode support is planned. Several transports are supported by GDB: * Serial * UDP * TCP (requires listen support) The GDB stub will support memory and register read/write. This includes support for breakpoint debugging. ==== Outline ==== ==== Milestones and Timeline ==== * Set up IDT and write interrupt handler. * Decide on interface for GDB transports and refactor serial console code to support serving as a GDB transport. * Implement GDB protocol encoder and decoder. * Implement memory read/write, including GDB scripts as tests. * Implement register read/write, including GDB scripts as tests. * Ensure that breakpoints are working, including GDB scripts as tests. * Implement UDP transport. * (Possibly) implement TCP transport and support TCP listen sockets. * (Possibly) support running as a gPXE process for memory peek/poke during execution. ==== Reference links ==== * [[http://code.google.com/soc/2008/etherboot/appinfo.html?csaid=13D4DE0EB18B0081|Google Summer of Code Application Information]] * [[http://sourceware.org/gdb/current/onlinedocs/gdb_18.html#SEC174|Debugging with GDB: Implementing a Remote Stub]] * [[http://sourceware.org/cgi-bin/cvsweb.cgi/src/gdb/i386-stub.c?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=src|GDB's i386-stub.c]]
