[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH 3/6] docs: Trace events must not expect pointer dere
From: |
Stefan Hajnoczi |
Subject: |
[Qemu-devel] [PATCH 3/6] docs: Trace events must not expect pointer dereferencing |
Date: |
Tue, 26 Apr 2011 13:26:00 +0100 |
Signed-off-by: Stefan Hajnoczi <address@hidden>
---
docs/tracing.txt | 5 +++++
1 files changed, 5 insertions(+), 0 deletions(-)
diff --git a/docs/tracing.txt b/docs/tracing.txt
index f15069c..905a083 100644
--- a/docs/tracing.txt
+++ b/docs/tracing.txt
@@ -69,6 +69,11 @@ Trace events should use types as follows:
cannot include all user-defined struct declarations and it is therefore
necessary to use void * for pointers to structs.
+ Pointers (including char *) cannot be dereferenced easily (or at all) in
+ some trace backends. If pointers are used, ensure they are meaningful by
+ themselves and do not assume the data they point to will be traced. Do
+ not pass in string arguments.
+
* For everything else, use primitive scalar types (char, int, long) with the
appropriate signedness.
--
1.7.4.1
- [Qemu-devel] [PULL 0/6] Tracing patches, Stefan Hajnoczi, 2011/04/26
- [Qemu-devel] [PATCH 6/6] trace: [trace-events] fix print formats in some events, Stefan Hajnoczi, 2011/04/26
- [Qemu-devel] [PATCH 1/6] tracetool: allow ) in trace output string, Stefan Hajnoczi, 2011/04/26
- [Qemu-devel] [PATCH 4/6] docs/tracing.txt: minor documentation fixes, Stefan Hajnoczi, 2011/04/26
- [Qemu-devel] [PATCH 5/6] trace: [ust] fix generation of 'trace.c' on events without args, Stefan Hajnoczi, 2011/04/26
- [Qemu-devel] [PATCH 2/6] trace: Remove %s in grlib trace events, Stefan Hajnoczi, 2011/04/26
- [Qemu-devel] [PATCH 3/6] docs: Trace events must not expect pointer dereferencing,
Stefan Hajnoczi <=
- Re: [Qemu-devel] [PULL 0/6] Tracing patches, Anthony Liguori, 2011/04/26