From patchwork Fri Oct 15 04:43:58 2010 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Prerna Saxena X-Patchwork-Id: 67885 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by ozlabs.org (Postfix) with ESMTPS id 178F2B70D9 for ; Fri, 15 Oct 2010 15:47:26 +1100 (EST) Received: from localhost ([127.0.0.1]:49588 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P6cCR-0005rp-1Y for incoming@patchwork.ozlabs.org; Fri, 15 Oct 2010 00:47:23 -0400 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 Received: from zephyr ([9.77.91.26]) by d28av01.in.ibm.com (8.14.4/8.13.1/NCO v10.0 AVin) with ESMTP id o9F4jkcj009844; Fri, 15 Oct 2010 10:15:47 +0530 Date: Fri, 15 Oct 2010 10:13:58 +0530 From: Prerna Saxena To: qemu-devel Message-ID: <20101015101358.27f92474@zephyr> In-Reply-To: <20101015100615.10915d2a@zephyr> References: <20101015100615.10915d2a@zephyr> Organization: IBM X-Mailer: Claws Mail 3.7.6 (GTK+ 2.20.1; i386-redhat-linux-gnu) Mime-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) Cc: Anthony Liguori , Hajnoczi , Mahesh , Stefan, Luiz Capitulino , Ananth Narayan Subject: [Qemu-devel] [Tracing][RFC v2 PATCH 2/2] Documentation for QMP interfaces X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: qemu-devel.nongnu.org List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org [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