[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL v5 39/44] docs/devel: tcg-plugins: add execlog plugin description
From: |
Alex Bennée |
Subject: |
[PULL v5 39/44] docs/devel: tcg-plugins: add execlog plugin description |
Date: |
Wed, 14 Jul 2021 16:00:31 +0100 |
From: Alexandre Iooss <erdnaxe@crans.org>
This adds description of the execlog TCG plugin with an example.
Signed-off-by: Alexandre Iooss <erdnaxe@crans.org>
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Message-Id: <20210702081307.1653644-3-erdnaxe@crans.org>
Message-Id: <20210709143005.1554-36-alex.bennee@linaro.org>
diff --git a/docs/devel/tcg-plugins.rst b/docs/devel/tcg-plugins.rst
index 0cd77c77d2..179867e9c1 100644
--- a/docs/devel/tcg-plugins.rst
+++ b/docs/devel/tcg-plugins.rst
@@ -320,3 +320,27 @@ the user to see what hardware is accessed how often. It
has a number of options:
off:0000001c, 1, 2
off:00000020, 1, 2
...
+
+- contrib/plugins/execlog.c
+
+The execlog tool traces executed instructions with memory access. It can be
used
+for debugging and security analysis purposes.
+Please be aware that this will generate a lot of output.
+
+The plugin takes no argument::
+
+ qemu-system-arm $(QEMU_ARGS) \
+ -plugin ./contrib/plugins/libexeclog.so -d plugin
+
+which will output an execution trace following this structure::
+
+ # vCPU, vAddr, opcode, disassembly[, load/store, memory addr, device]...
+ 0, 0xa12, 0xf8012400, "movs r4, #0"
+ 0, 0xa14, 0xf87f42b4, "cmp r4, r6"
+ 0, 0xa16, 0xd206, "bhs #0xa26"
+ 0, 0xa18, 0xfff94803, "ldr r0, [pc, #0xc]", load, 0x00010a28, RAM
+ 0, 0xa1a, 0xf989f000, "bl #0xd30"
+ 0, 0xd30, 0xfff9b510, "push {r4, lr}", store, 0x20003ee0, RAM, store,
0x20003ee4, RAM
+ 0, 0xd32, 0xf9893014, "adds r0, #0x14"
+ 0, 0xd34, 0xf9c8f000, "bl #0x10c8"
+ 0, 0x10c8, 0xfff96c43, "ldr r3, [r0, #0x44]", load, 0x200000e4, RAM
--
2.20.1
- [PULL v5 08/44] build: validate that system capstone works before using it, (continued)
- [PULL v5 08/44] build: validate that system capstone works before using it, Alex Bennée, 2021/07/14
- [PULL v5 04/44] Jobs based on custom runners: add job definitions for QEMU's machines, Alex Bennée, 2021/07/14
- [PULL v5 07/44] disable modular TCG on Darwin, Alex Bennée, 2021/07/14
- [PULL v5 02/44] Jobs based on custom runners: build environment docs and playbook, Alex Bennée, 2021/07/14
- [PULL v5 09/44] gitlab: support for FreeBSD 12, 13 and macOS 11 via cirrus-run, Alex Bennée, 2021/07/14
- [PULL v5 06/44] meson: fix condition for io_uring stubs, Alex Bennée, 2021/07/14
- [PULL v5 10/44] cirrus: delete FreeBSD and macOS jobs, Alex Bennée, 2021/07/14
- [PULL v5 11/44] hw/usb/ccid: remove references to NSS, Alex Bennée, 2021/07/14
- [PULL v5 14/44] tests/docker: use explicit docker.io registry, Alex Bennée, 2021/07/14
- [PULL v5 12/44] tests/docker: don't use BUILDKIT in GitLab either, Alex Bennée, 2021/07/14
- [PULL v5 39/44] docs/devel: tcg-plugins: add execlog plugin description,
Alex Bennée <=
- [PULL v5 23/44] tests/docker: expand ubuntu1804 package list, Alex Bennée, 2021/07/14
- [PULL v5 36/44] tcg/plugins: enable by default for most TCG builds, Alex Bennée, 2021/07/14
- [PULL v5 44/44] MAINTAINERS: Added myself as a reviewer for TCG Plugins, Alex Bennée, 2021/07/14
- [PULL v5 34/44] configure: add an explicit static and plugins check, Alex Bennée, 2021/07/14
- [PULL v5 26/44] tests/vm: update NetBSD to 9.2, Alex Bennée, 2021/07/14
- [PULL v5 24/44] tests/docker: expand ubuntu2004 package list, Alex Bennée, 2021/07/14
- [PULL v5 40/44] plugins: Added a new cache modelling plugin, Alex Bennée, 2021/07/14
- [PULL v5 22/44] tests/docker: expand fedora package list, Alex Bennée, 2021/07/14
- [PULL v5 30/44] meson.build: move TCG plugin summary output, Alex Bennée, 2021/07/14
- [PULL v5 20/44] tests/docker: remove mingw packages from Fedora, Alex Bennée, 2021/07/14