[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v2 10/19] docs/devel: document query handle lifetimes
From: |
Alex Bennée |
Subject: |
[PATCH v2 10/19] docs/devel: document query handle lifetimes |
Date: |
Thu, 13 Feb 2020 22:51:00 +0000 |
I forgot to document the lifetime of handles in the developer
documentation. Do so now.
Signed-off-by: Alex Bennée <address@hidden>
Reviewed-by: Robert Foley <address@hidden>
Reviewed-by: Robert Foley <address@hidden>
---
docs/devel/tcg-plugins.rst | 13 +++++++++++--
1 file changed, 11 insertions(+), 2 deletions(-)
diff --git a/docs/devel/tcg-plugins.rst b/docs/devel/tcg-plugins.rst
index 718eef00f22..a05990906cc 100644
--- a/docs/devel/tcg-plugins.rst
+++ b/docs/devel/tcg-plugins.rst
@@ -51,8 +51,17 @@ about how QEMU's translation works to the plugins. While
there are
conceptions such as translation time and translation blocks the
details are opaque to plugins. The plugin is able to query select
details of instructions and system configuration only through the
-exported *qemu_plugin* functions. The types used to describe
-instructions and events are opaque to the plugins themselves.
+exported *qemu_plugin* functions.
+
+Query Handle Lifetime
+---------------------
+
+Each callback provides an opaque anonymous information handle which
+can usually be further queried to find out information about a
+translation, instruction or operation. The handles themselves are only
+valid during the lifetime of the callback so it is important that any
+information that is needed is extracted during the callback and saved
+by the plugin.
Usage
=====
--
2.20.1
- [PATCH v2 02/19] tests/rcutorture: update usage hint, (continued)
- [PATCH v2 02/19] tests/rcutorture: update usage hint, Alex Bennée, 2020/02/13
- [PATCH v2 03/19] tests/rcutorture: better document locking of stats, Alex Bennée, 2020/02/13
- [PATCH v2 05/19] travis.yml: Test the s390-ccw build, too, Alex Bennée, 2020/02/13
- [PATCH v2 06/19] travis.yml: Fix Travis YAML configuration warnings, Alex Bennée, 2020/02/13
- [PATCH v2 04/19] tests/rcutorture: mild documenting refactor of update thread, Alex Bennée, 2020/02/13
- [PATCH v2 07/19] travis.yml: single-thread build-tcg stages, Alex Bennée, 2020/02/13
- [PATCH v2 08/19] tests/iotests: be a little more forgiving on the size test, Alex Bennée, 2020/02/13
- [PATCH v2 13/19] qemu/bitops.h: Add extract8 and extract16, Alex Bennée, 2020/02/13
- [PATCH v2 10/19] docs/devel: document query handle lifetimes,
Alex Bennée <=
- [PATCH v2 11/19] plugins/core: add missing break in cb_to_tcg_flags, Alex Bennée, 2020/02/13
- [PATCH v2 09/19] tracing: only allow -trace to override -D if set, Alex Bennée, 2020/02/13
- [PATCH v2 12/19] tests/plugin: prevent uninitialized warning, Alex Bennée, 2020/02/13
- [PATCH v2 17/19] tcg: save vaddr temp for plugin usage, Alex Bennée, 2020/02/13
- [PATCH v2 15/19] tests/plugins: make howvec clean-up after itself., Alex Bennée, 2020/02/13
- [PATCH v2 14/19] target/riscv: progressively load the instruction during decode, Alex Bennée, 2020/02/13