[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v3 10/19] docs/devel: document query handle lifetimes
From: |
Alex Bennée |
Subject: |
[PATCH v3 10/19] docs/devel: document query handle lifetimes |
Date: |
Tue, 25 Feb 2020 12:47:01 +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 v3 03/19] tests/rcutorture: better document locking of stats, (continued)
- [PATCH v3 03/19] tests/rcutorture: better document locking of stats, Alex Bennée, 2020/02/25
- [PATCH v3 04/19] tests/rcutorture: mild documenting refactor of update thread, Alex Bennée, 2020/02/25
- [PATCH v3 05/19] travis.yml: Test the s390-ccw build, too, Alex Bennée, 2020/02/25
- [PATCH v3 09/19] tracing: only allow -trace to override -D if set, Alex Bennée, 2020/02/25
- [PATCH v3 06/19] travis.yml: Fix Travis YAML configuration warnings, Alex Bennée, 2020/02/25
- [PATCH v3 07/19] travis.yml: single-thread build-tcg stages, Alex Bennée, 2020/02/25
- [PATCH v3 08/19] tests/iotests: be a little more forgiving on the size test, Alex Bennée, 2020/02/25
- [PATCH v3 10/19] docs/devel: document query handle lifetimes,
Alex Bennée <=
- [PATCH v3 13/19] qemu/bitops.h: Add extract8 and extract16, Alex Bennée, 2020/02/25
- [PATCH v3 11/19] plugins/core: add missing break in cb_to_tcg_flags, Alex Bennée, 2020/02/25
- [PATCH v3 12/19] tests/plugin: prevent uninitialized warning, Alex Bennée, 2020/02/25
- [PATCH v3 19/19] tests/tcg: take into account expected clashes pauth-4, Alex Bennée, 2020/02/25
- [PATCH v3 16/19] tests/tcg: give debug builds a little bit longer, Alex Bennée, 2020/02/25
- [PATCH v3 15/19] tests/plugins: make howvec clean-up after itself., Alex Bennée, 2020/02/25
- [PATCH v3 17/19] tcg: save vaddr temp for plugin usage, Alex Bennée, 2020/02/25