From patchwork Thu Mar 21 08:35:42 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hu Tao X-Patchwork-Id: 229581 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by ozlabs.org (Postfix) with ESMTPS id 9F0932C00CB for ; Thu, 21 Mar 2013 19:36:33 +1100 (EST) Received: from localhost ([::1]:59842 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIaz9-00053p-S9 for incoming@patchwork.ozlabs.org; Thu, 21 Mar 2013 04:36:31 -0400 Received: from eggs.gnu.org ([208.118.235.92]:52060) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIayf-00051b-0X for qemu-devel@nongnu.org; Thu, 21 Mar 2013 04:36:05 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UIaya-0003BO-Hp for qemu-devel@nongnu.org; Thu, 21 Mar 2013 04:36:00 -0400 Received: from [222.73.24.84] (port=10457 helo=song.cn.fujitsu.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIayZ-0003Am-PF for qemu-devel@nongnu.org; Thu, 21 Mar 2013 04:35:56 -0400 X-IronPort-AV: E=Sophos;i="4.84,884,1355068800"; d="scan'208";a="6916816" Received: from unknown (HELO tang.cn.fujitsu.com) ([10.167.250.3]) by song.cn.fujitsu.com with ESMTP; 21 Mar 2013 16:33:13 +0800 Received: from fnstmail02.fnst.cn.fujitsu.com (tang.cn.fujitsu.com [127.0.0.1]) by tang.cn.fujitsu.com (8.14.3/8.13.1) with ESMTP id r2L8Zd7l005132; Thu, 21 Mar 2013 16:35:42 +0800 Received: from localhost.localdomain ([10.167.233.156]) by fnstmail02.fnst.cn.fujitsu.com (Lotus Domino Release 8.5.3) with ESMTP id 2013032116341186-1041179 ; Thu, 21 Mar 2013 16:34:11 +0800 From: Hu Tao To: qemu-devel , "Daniel P. Berrange" , KAMEZAWA Hiroyuki , Jan Kiszka , Gleb Natapov , Blue Swirl , Eric Blake , Andrew Jones , Marcelo Tosatti , Sasha Levin , Luiz Capitulino , Anthony Liguori , Markus Armbruster , Paolo Bonzini , Stefan Hajnoczi , Juan Quintela , Orit Wasserman , Wen Congyang , "Michael S. Tsirkin" , Alexander Graf , Alex Williamson , Peter Maydell , Christian Borntraeger Date: Thu, 21 Mar 2013 16:35:42 +0800 Message-Id: <88d002a0bd3acbd0d244f51fcef8f1d1860a2812.1363847790.git.hutao@cn.fujitsu.com> X-Mailer: git-send-email 1.8.1.4 In-Reply-To: References: X-MIMETrack: Itemize by SMTP Server on mailserver/fnst(Release 8.5.3|September 15, 2011) at 2013/03/21 16:34:11, Serialize by Router on mailserver/fnst(Release 8.5.3|September 15, 2011) at 2013/03/21 16:34:15, Serialize complete at 2013/03/21 16:34:15 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 222.73.24.84 Subject: [Qemu-devel] [PATCH v15 4/6] pvpanic: add document of pvpanic X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Signed-off-by: Hu Tao --- docs/specs/pvpanic.txt | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/specs/pvpanic.txt diff --git a/docs/specs/pvpanic.txt b/docs/specs/pvpanic.txt new file mode 100644 index 0000000..761d20c --- /dev/null +++ b/docs/specs/pvpanic.txt @@ -0,0 +1,25 @@ +PVPANIC DEVICE +============== + +pvpanic device is a simulated ISA device, through which guest panic +event is sent to qemu, and a QMP event is generated. This allows +management apps(e.g. libvirt) to be notified and respond to the +event. + +pvpanic uses port 0x505 by default to receive panic event from guest. +The port is configurable by specifying ioport property. + +pvpanic device is defined with ACPI ID "QEMU0001". To send panic +event, guest evaluates method WRPT, specifying a byte, bit 0 set, +as argument. Other bits are reserved. + +To use it, one will have to: + +1. add the device by specifying `-device pvpanic' in the qemu command + line. + +2. load pvpanic device driver in guest OS. + +The management app has the options of waiting for GUEST_PANICKED events, +and/or polling for guest-panicked RunState, to learn when the pvpanic +device has fired a panic event.