Commit acb0a27eb8 for

commit acb0a27eb85ccf5de6052bf7407531e76fb13a5d
Author: Peter Maydell <>
Date:   Thu Apr 1 11:25:27 2021 +0100

    docs/system/gdb.rst: Add some more heading structure

    We're about to add a new section to gdb.rst. In
    preparation, add some more headings so it isn't just
    one huge run-on section.

    Signed-off-by: Peter Maydell <>
    Signed-off-by: Alex Bennée <>
    Reviewed-by: Philippe Mathieu-Daudé <>
    Message-Id: <>
    Message-Id: <>

diff --git a/docs/system/gdb.rst b/docs/system/gdb.rst
index 72b1e68f4e..0bb1bedf1b 100644
--- a/docs/system/gdb.rst
+++ b/docs/system/gdb.rst
@@ -45,7 +45,11 @@ Here are some useful tips in order to use gdb on system code:
 3. Use ``set architecture i8086`` to dump 16 bit code. Then use
    ``x/10i $cs*16+$eip`` to dump the code at the PC position.

-Advanced debugging options:
+Advanced debugging options
+Changing single-stepping behaviour

 The default single stepping behavior is step with the IRQs and timer
 service routines off. It is set this way because when gdb executes a
@@ -88,6 +92,8 @@ three commands you can query and set the single step behavior:
       sending: "qemu.sstep=0x5"
       received: "OK"

+Examining physical memory

 Another feature that QEMU gdbstub provides is to toggle the memory GDB
 works with, by default GDB will show the current process memory respecting