aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorAlexandre Iooss <erdnaxe@crans.org>2024-06-20 15:57:32 +0200
committerThomas Huth <thuth@redhat.com>2024-07-02 09:36:39 +0200
commit5f79abcf74d32d7b9cef3481df2c354fc0cad540 (patch)
tree9ed73bdc3e2311a8e38e28f43605d2c44d672178 /docs
parent4ab2546265c2133395c163bbdf2bea2ea30e3989 (diff)
downloadqemu-5f79abcf74d32d7b9cef3481df2c354fc0cad540.zip
qemu-5f79abcf74d32d7b9cef3481df2c354fc0cad540.tar.gz
qemu-5f79abcf74d32d7b9cef3481df2c354fc0cad540.tar.bz2
docs: add precision about capstone for execlog plugin
Some people are wondering why they get an empty string as disassembly. Most of the time, they configured QEMU without Capstone support. Let's document this behaviour to help users. Signed-off-by: Alexandre Iooss <erdnaxe@crans.org> Reviewed-by: Pierrick Bouvier <pierrick.bouvier@linaro.org> Message-ID: <20240620135731.977377-1-erdnaxe@crans.org> Signed-off-by: Thomas Huth <thuth@redhat.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/devel/tcg-plugins.rst4
1 files changed, 3 insertions, 1 deletions
diff --git a/docs/devel/tcg-plugins.rst b/docs/devel/tcg-plugins.rst
index 9cc09d8..f7d7b9e 100644
--- a/docs/devel/tcg-plugins.rst
+++ b/docs/devel/tcg-plugins.rst
@@ -539,7 +539,9 @@ which will output an execution trace following this structure::
0, 0xd34, 0xf9c8f000, "bl #0x10c8"
0, 0x10c8, 0xfff96c43, "ldr r3, [r0, #0x44]", load, 0x200000e4, RAM
-the output can be filtered to only track certain instructions or
+Please note that you need to configure QEMU with Capstone support to get disassembly.
+
+The output can be filtered to only track certain instructions or
addresses using the ``ifilter`` or ``afilter`` options. You can stack the
arguments if required::