zephyr/samples/subsys/debug/gdbstub
Anas Nashif b835b02136 tests: cleanup metadata and filtering
- Add integration_platforms to avoid excessive filtering
- Make sure integration platforms are actually part of the filter
- Fix some tags and test meta data

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-06-13 09:38:27 -04:00
..
boards debug: gdbstub: Move to DTS for uart device 2022-08-01 09:09:45 -07:00
src samples, tests, boards: Switch main return type from void to int 2023-04-14 07:49:41 +09:00
CMakeLists.txt samples: debug/gdbstub: update instructions to run 2021-11-30 15:24:00 -05:00
prj.conf debug: gdbstub: Move to DTS for uart device 2022-08-01 09:09:45 -07:00
README.rst samples: debug/gdbstub: update instructions to run 2021-11-30 15:24:00 -05:00
run.gdbinit
sample.yaml tests: cleanup metadata and filtering 2023-06-13 09:38:27 -04:00

.. _gdb_debug_sample:

GDB Debug Sample
################

Overview
********

A simple sample that can be used with QEMU to show debug using GDB
Remote Serial Protocol (RSP) capabilities.

Building and Running
********************

This application can be built and executed on QEMU as follows:

.. zephyr-app-commands::
   :zephyr-app: samples/subsys/debug/gdbstub
   :host-os: unix
   :board: qemu_x86
   :goals: run
   :compact:

Open a new terminal and use gdb to connect to the running qemu as follows:

.. code-block:: bash

    gdb build/zephyr/zephyr.elf
    (gdb) target remote :5678

Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.