From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([208.118.235.92]:55590) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIwCM-000644-Sr for qemu-devel@nongnu.org; Fri, 22 Mar 2013 03:15:36 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UIwCL-0006tl-70 for qemu-devel@nongnu.org; Fri, 22 Mar 2013 03:15:34 -0400 Received: from [222.73.24.84] (port=22627 helo=song.cn.fujitsu.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIwCK-0006pm-Rj for qemu-devel@nongnu.org; Fri, 22 Mar 2013 03:15:33 -0400 Date: Fri, 22 Mar 2013 15:15:28 +0800 From: Hu Tao Message-ID: <20130322071528.GC24459@localhost.localdomain> References: <88d002a0bd3acbd0d244f51fcef8f1d1860a2812.1363847790.git.hutao@cn.fujitsu.com> <514ACF4E.6030505@redhat.com> MIME-Version: 1.0 In-Reply-To: <514ACF4E.6030505@redhat.com> Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Subject: Re: [Qemu-devel] [PATCH v15 4/6] pvpanic: add document of pvpanic List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Paolo Bonzini Cc: Peter Maydell , Gleb Natapov , "Michael S. Tsirkin" , Jan Kiszka , qemu-devel , Markus Armbruster , Blue Swirl , Orit Wasserman , Juan Quintela , Alexander Graf , Christian Borntraeger , Andrew Jones , Alex Williamson , Sasha Levin , Stefan Hajnoczi , Luiz Capitulino , KAMEZAWA Hiroyuki , Anthony Liguori , Marcelo Tosatti On Thu, Mar 21, 2013 at 10:13:50AM +0100, Paolo Bonzini wrote: > Il 21/03/2013 09:35, Hu Tao ha scritto: > > 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. > > Please document the ISA interface too. > > > +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. > > Please document RDPT too, and mention that the ACPI device will > automatically refer to the right port in case it is modified. > > > +To use it, one will have to: > > + > > +1. add the device by specifying `-device pvpanic' in the qemu command > > + line. > > As mentioned earlier, I'd like this to be the default in 1.5 and newer > machine types. I must have missed it. Thanks for review! > > Paolo > > > +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. > >