From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from [140.186.70.92] (port=58062 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P6cB1-0005OS-5E for qemu-devel@nongnu.org; Fri, 15 Oct 2010 00:45:56 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1P6cB0-0002ix-3p for qemu-devel@nongnu.org; Fri, 15 Oct 2010 00:45:55 -0400 Received: from e28smtp05.in.ibm.com ([122.248.162.5]:59568) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1P6cAz-0002ip-ED for qemu-devel@nongnu.org; Fri, 15 Oct 2010 00:45:54 -0400 Received: from d28relay03.in.ibm.com (d28relay03.in.ibm.com [9.184.220.60]) by e28smtp05.in.ibm.com (8.14.4/8.13.1) with ESMTP id o9F4jmlt002129 for ; Fri, 15 Oct 2010 10:15:48 +0530 Received: from d28av01.in.ibm.com (d28av01.in.ibm.com [9.184.220.63]) by d28relay03.in.ibm.com (8.13.8/8.13.8/NCO v10.0) with ESMTP id o9F4jmeB4386984 for ; Fri, 15 Oct 2010 10:15:48 +0530 Received: from d28av01.in.ibm.com (loopback [127.0.0.1]) by d28av01.in.ibm.com (8.14.4/8.13.1/NCO v10.0 AVout) with ESMTP id o9F4jmqi009883 for ; Fri, 15 Oct 2010 10:15:48 +0530 Date: Fri, 15 Oct 2010 10:13:58 +0530 From: Prerna Saxena Message-ID: <20101015101358.27f92474@zephyr> In-Reply-To: <20101015100615.10915d2a@zephyr> References: <20101015100615.10915d2a@zephyr> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: [Qemu-devel] [Tracing][RFC v2 PATCH 2/2] Documentation for QMP interfaces List-Id: qemu-devel.nongnu.org List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: qemu-devel Cc: Anthony Liguori , Hajnoczi , Mahesh , Stefan@gnu.org, Luiz Capitulino , Ananth Narayan [PATCH 2/2] Add documentation for QMP commands: query-trace & query-trace-events. Signed-off-by: Prerna Saxena --- qmp-commands.hx | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 71 insertions(+), 0 deletions(-) diff --git a/qmp-commands.hx b/qmp-commands.hx index 793cf1c..fefc93d 100644 --- a/qmp-commands.hx +++ b/qmp-commands.hx @@ -1539,3 +1539,74 @@ Example: EQMP +SQMP +query-trace +------------- + +Show contents of trace buffer. + +Returns a set of json-objects containing the following data: + +- "event": Event ID for the trace-event(json-int) +- "timestamp": trace timestamp (json-int) +- "arg1 .. arg6": Arguments logged by the trace-event (json-int) + +Example: + +-> { "execute": "query-trace" } +<- { + "return":{ + "event": 22, + "timestamp": 129456235912365, + "arg1": 886 + "arg2": 80, + "arg3": 0, + "arg4": 0, + "arg5": 0, + "arg6": 0, + }, + { + "event": 22, + "timestamp": 129456235973407, + "arg1": 886, + "arg2": 80, + "arg3": 0, + "arg4": 0, + "arg5": 0, + "arg6": 0 + }, + ... + } + +EQMP + +SQMP +query-trace-events +------------------ + +Show all available trace-events & their state. + +Returns a set of json-objects containing the following data: + +- "name": Name of Trace-event (json-string) +- "event-id": Event ID of Trace-event (json-int) +- "state": State of trace-event [ '0': inactive; '1':active ] (json-int) + +Example: + +-> { "execute": "query-trace-events" } +<- { + "return":{ + "name": "qemu_malloc", + "event-id": 0 + "state": 0, + }, + { + "name": "qemu_realloc", + "event-id": 1, + "state": 0 + }, + ... + } + +EQMP -- 1.7.2.2 -- Prerna Saxena Linux Technology Centre, IBM Systems and Technology Lab, Bangalore, India