| .. _debug_sample: |
| |
| Debug Sample |
| ############ |
| |
| Overview |
| ******** |
| |
| A simple sample that can be used with qemu to show debug using gdb |
| remote serial protocol capabilities. |
| |
| Building and Running |
| ******************** |
| |
| This application can be built and executed on QEMU as follows: |
| |
| .. zephyr-app-commands:: |
| :zephyr-app: samples/debug |
| :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 :1234 |
| |
| Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`. |
