Commit 50679467 authored by Jon Doron's avatar Jon Doron Committed by Alex Bennée
Browse files

docs: Add to gdbstub documentation the PhyMemMode 



The PhyMemMode gdb extension command was missing from the gdb.rst
document.

Signed-off-by: default avatarJon Doron <arilou@gmail.com>
Signed-off-by: default avatarAlex Bennée <alex.bennee@linaro.org>
Reviewed-by: default avatarPhilippe Mathieu-Daudé <f4bug@amsat.org>
Message-Id: <20200601171609.1665397-1-arilou@gmail.com>
Message-Id: <20200709141327.14631-4-alex.bennee@linaro.org>
parent 4d7fe02b

docs/system/gdb.rst

+20 −0
Original line number Diff line number Diff line
@@ -87,3 +87,23 @@ three commands you can query and set the single step behavior: 
      (gdb) maintenance packet Qqemu.sstep=0x5

      sending: "qemu.sstep=0x5"

      received: "OK"





Another feature that QEMU gdbstub provides is to toggle the memory GDB

works with, by default GDB will show the current process memory respecting

the virtual address translation.



If you want to examine/change the physical memory you can set the gdbstub

to work with the physical memory rather with the virtual one.



The memory mode can be checked by sending the following command:



``maintenance packet qqemu.PhyMemMode``

    This will return either 0 or 1, 1 indicates you are currently in the

    physical memory mode.



``maintenance packet Qqemu.PhyMemMode:1``

    This will change the memory mode to physical memory.



``maintenance packet Qqemu.PhyMemMode:0``

    This will change it back to normal memory mode.