zephyr/doc/guides/debugging/gdbstub.rst

35 lines
966 B
ReStructuredText

.. _gdbgstub:
GDB stub
########
Overview
********
The gdbstub feature provides an implementation of the GDB Remote
Serial Protocol (RSP) that allows you to remotely debug Zephyr
using GDB.
The protocol supports different connection types: serial, UDP/IP and
TCP/IP. Zephyr currently supports only serial device communication.
The GDB program acts as the client while Zephyr acts as the
server. When this feature is enabled, Zephyr stops its execution after
``gdb_init()`` starts gdbstub service and waits for a GDB
connection. Once a connection is established it is possible to
synchronously interact with Zephyr. Note that currently it is not
possible to asynchronously send commands to the target.
Enable this feature with the :option:`CONFIG_GDBSTUB` option.
Features
********
The following features are supported:
* Add and remove breakpoints
* Continue and step the target
* Print backtrace
* Read or write general registers
* Read or write the memory