~ubuntu-branches/ubuntu/saucy/qemu/saucy-proposed

« back to all changes in this revision

Viewing changes to docs/specs/pvpanic.txt

  • Committer: Package Import Robot
  • Author(s): Serge Hallyn
  • Date: 2013-05-28 08:18:30 UTC
  • mfrom: (1.8.2) (10.1.37 sid)
  • Revision ID: package-import@ubuntu.com-20130528081830-87xl2z9fq516a814
Tags: 1.5.0+dfsg-2ubuntu1
* Merge 1.5.0+dfs-2 from debian unstable.  Remaining changes:
  - debian/control
    * update maintainer
    * remove libiscsi, usb-redir, vde, vnc-jpeg, and libssh2-1-dev
      from build-deps
    * enable rbd
    * add qemu-system and qemu-common B/R to qemu-keymaps
    * add D:udev, R:qemu, R:qemu-common and B:qemu-common to
      qemu-system-common
    * qemu-system-arm, qemu-system-ppc, qemu-system-sparc:
      - add qemu-kvm to Provides
      - add qemu-common, qemu-kvm, kvm to B/R
      - remove openbios-sparc from qemu-system-sparc D
    * qemu-system-x86:
      - add qemu-common to Breaks/Replaces.
      - add cpu-checker to Recommends.
    * qemu-user: add B/R:qemu-kvm
    * qemu-kvm:
      - add armhf armel powerpc sparc to Architecture
      - C/R/P: qemu-kvm-spice
    * add qemu-common package
    * drop qemu-slof which is not packaged in ubuntu
  - add qemu-system-common.links for tap ifup/down scripts and OVMF link.
  - qemu-system-x86.links:
    * remove pxe rom links which are in kvm-ipxe
    * add symlink for kvm.1 manpage
  - debian/rules
    * add kvm-spice symlink to qemu-kvm
    * call dh_installmodules for qemu-system-x86
    * update dh_installinit to install upstart script
    * run dh_installman (Closes: #709241) (cherrypicked from 1.5.0+dfsg-2)
  - Add qemu-utils.links for kvm-* symlinks.
  - Add qemu-system-x86.qemu-kvm.upstart and .default
  - Add qemu-system-x86.modprobe to set nesting=1
  - Add qemu-system-common.preinst to add kvm group
  - qemu-system-common.postinst: remove bad group acl if there, then have
    udev relabel /dev/kvm.
  - Dropped patches:
    * 0001-fix-wrong-output-with-info-chardev-for-tcp-socket.patch
  - Kept patches:
    * expose_vms_qemu64cpu.patch - updated
    * gridcentric patch - updated
    * linaro arm patches from qemu-linaro rebasing branch

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
PVPANIC DEVICE
 
2
==============
 
3
 
 
4
pvpanic device is a simulated ISA device, through which a guest panic
 
5
event is sent to qemu, and a QMP event is generated. This allows
 
6
management apps (e.g. libvirt) to be notified and respond to the event.
 
7
 
 
8
The management app has the option of waiting for GUEST_PANICKED events,
 
9
and/or polling for guest-panicked RunState, to learn when the pvpanic
 
10
device has fired a panic event.
 
11
 
 
12
ISA Interface
 
13
-------------
 
14
 
 
15
pvpanic exposes a single I/O port, by default 0x505. On read, the bits
 
16
recognized by the device are set. Software should ignore bits it doesn't
 
17
recognize. On write, the bits not recognized by the device are ignored.
 
18
Software should set only bits both itself and the device recognize.
 
19
Currently, only bit 0 is recognized, setting it indicates a guest panic
 
20
has happened.
 
21
 
 
22
ACPI Interface
 
23
--------------
 
24
 
 
25
pvpanic device is defined with ACPI ID "QEMU0001". Custom methods:
 
26
 
 
27
RDPT:       To determine whether guest panic notification is supported.
 
28
Arguments:  None
 
29
Return:     Returns a byte, bit 0 set to indicate guest panic
 
30
            notification is supported. Other bits are reserved and
 
31
            should be ignored.
 
32
 
 
33
WRPT:       To send a guest panic event
 
34
Arguments:  Arg0 is a byte, with bit 0 set to indicate guest panic has
 
35
            happened. Other bits are reserved and should be cleared.
 
36
Return:     None
 
37
 
 
38
The ACPI device will automatically refer to the right port in case it
 
39
is modified.