Re: [Qemu-devel] [PATCH v14 4/4] pvevent: add document to describe the usage

[Eric Blake <eblake@redhat.com>]

[-- Attachment #1: Type: text/plain, Size: 1312 bytes --]

On 03/14/2013 02:15 AM, Hu Tao wrote:
> Signed-off-by: Hu Tao <hutao@cn.fujitsu.com>
> ---
>  docs/pvevent.txt | 16 ++++++++++++++++
>  1 file changed, 16 insertions(+)
>  create mode 100644 docs/pvevent.txt
> 
> diff --git a/docs/pvevent.txt b/docs/pvevent.txt
> new file mode 100644
> index 0000000..749b87c
> --- /dev/null
> +++ b/docs/pvevent.txt
> @@ -0,0 +1,16 @@
> +PVEVENT DEVICE
> +==============
> +
> +pvevent device is a simulated ISA device, through which guest panic
> +event is sent to qemu, and an qmp event is generated. This allows

s/an qmp/a QMP/ - although mentioning _which_ event might be niceer.

> +management apps(e.g. libvirt) to be notified and respond to the

s/apps(/apps (/

> +event.
> +
> +pvevent device is defined with HID "MSFT0001".
> +
> +To use it, one will have to:
> +
> +1. add the device by specifying `-device pv-event' in the qemu command
> +   line.
> +
> +2. load pvevent device driver in guest OS.

Missing is a sentence stating that the management app then has the
option of waiting for GUEST_PANICKED events, and/or polling for
guest-panicked RunState, to learn when the pvevent device has fired a
panic event.

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 621 bytes --]