✎ soc:2008:stefanha:project_plan:start

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== 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.
  * Implement continue and single-step, including GDB scripts as tests.
  * Ensure that breakpoints are working, including GDB scripts as tests.
  * Implement miscellaneous GDB protocol commands like detach/kill, include
  * Implement UDP transport.
  * Documentation (how to debug, how to run tests).
  * (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]]

Trace: • week7 • ubuntubko • week10 • win2k8_iscsi_install • ideas • week4 • 2008 • qemupxeknifehttp • iscsibootprepw2k3 • debian_and_ubuntu • iscsibootprepfc5 • audit-the-shifts • fedora11bko