Bug 620657 (unsupported)

This issue has been proposed when we are only considering blocker
issues in the current Red Hat Enterprise Linux release.

** If you would still like this issue considered for the current
release, ask your support representative to file as a blocker on
your behalf. Otherwise ask that it be considered for the next
Red Hat Enterprise Linux release. **

For each device, we need to:

1. Enumerate the ways the user can configure this device via a supported interface.

2. For each such way, determine whether it is a supported use of the device.  Take care to distinguish between hot-plug and cold-plug.


The currently enabled devices follow.

NICs:
name "virtio-net-pci", bus PCI
name "i82562", bus PCI
name "i82559er", bus PCI
name "i82559c", bus PCI
name "i82559b", bus PCI
name "i82559a", bus PCI
name "i82558b", bus PCI
name "i82558a", bus PCI
name "i82557c", bus PCI
name "i82557b", bus PCI
name "i82557a", bus PCI
name "i82551", bus PCI
name "i82550", bus PCI
name "pcnet", bus PCI
name "rtl8139", bus PCI
name "e1000", bus PCI, desc "Intel Gigabit Ethernet"
name "ne2k_isa", bus ISA
name "ne2k_pci", bus PCI

Disk controllers & drives:
name "virtio-blk-pci", bus PCI
name "ide-drive", bus IDE
name "isa-ide", bus ISA

Graphics:
name "VGA", bus PCI
name "cirrus-vga", bus PCI, desc "Cirrus CLGD 54xx VGA"
name "vmware-svga", bus PCI
name "qxl", bus PCI, desc "Spice QXL GPU"

Sound:
name "ES1370", bus PCI, desc "ENSONIQ AudioPCI ES1370"
name "AC97", bus PCI, desc "Intel 82801AA AC97 Audio"

Virtio-serial:
name "virtio-serial-pci", bus PCI, alias "virtio-serial"
name "virtserialport", bus virtio-serial-bus
name "virtconsole", bus virtio-serial-bus
name "spicevmc", bus virtio-serial-bus

Watchdogs:
name "ib700", bus ISA
name "i6300esb", bus PCI

USB:
name "piix4-usb-uhci", bus PCI
name "piix3-usb-uhci", bus PCI
name "usb-hub", bus USB
name "usb-host", bus USB
name "usb-kbd", bus USB
name "usb-mouse", bus USB
name "usb-tablet", bus USB
name "usb-wacom-tablet", bus USB, desc "QEMU PenPartner Tablet"
name "usb-braille", bus USB
name "usb-serial", bus USB
name "usb-net", bus USB
name "usb-bt-dongle", bus USB

Other PCI:
name "pci-bridge", bus PCI
name "virtio-balloon-pci", bus PCI
name "pci-assign", bus PCI, desc "pass through host pci devices to the guest"

Other non-PCI:
name "SUNW,fdtwo", bus System
name "sysbus-fdc", bus System
name "isa-serial", bus ISA
name "isa-parallel", bus ISA
name "testdev", bus ISA
name "smbus-eeprom", bus I2C

    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
This is a draft.  Holes:

* Character device support
* Document at a higher level than just domain XML

To be completed until Friday, Sep 17.

=== Hypervisor type ===

Only KVM is supported.

Element domain
    Attribute type
    Supported values: kvm

=== CPU model and topology ===

Configuration must result in a virtual CPU and topology that matches a supported physical CPU and topology.

Element domain
    Element cpu

=== Guest ACPI ===

Running guests without ACPI is not supported.

Element domain
    Element features
        Element acpi must be present

=== Device emulator ===

Replacing or wrapping the default device emulator is not supported.

Element domain
    Element devices
        Element emulator
	Supported contents: %{_libexecdir}/qemu-kvm

=== Host device pass through ===

PCI pass through requires hardware certified for it.  USB pass through is not supported.

Element domain
    Element devices
        Element hostdev
	    Attribute type
	    Supported values: pci

=== Network devices ===

Supported back ends are "virtual network", "bridge to LAN" and "direct attachment to physical interface".

Supported virtual NICs are virtio-net, rtl8139, e1000.

Element domain
    Element devices
        Element interface
	    Attribute type
	    Supported values: bridge, network, direct
	    Element model
	        Attribute type
		Supported values: virtio-net, rtl8139, e1000

=== Input devices ===

PS/2 mouse and USB tablet are supported.

Element domain
    Element devices
        Element input
	    Attributes type, bus
	    Supported values: type=tablet bus=usb
			      type=mouse bus=ps2

=== Graphics devices ===

Back ends VNC and Spice are supported.

Graphics devices standard VGA, Cirrus and QXL are supported.

Element domain
    Element devices
        Element graphics
            Attribute type
            Supported values: vnc, spice
	Element video
	    Element model
	        Attribute type
		Supported values: vga, cirrus, qxl

=== Character devices ===

FIXME awaiting input from QA

=== Sound devices ===

Sound devices es1370 and ac97 are supported.

Element domain
    Element devices
        Element sound
        Attribute model
        Supported values: es1370, ac97

    Technical note updated. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    Diffed Contents:
@@ -1,6 +1,6 @@
 This is a draft.  Holes:
 
-* Character device support
+* Ongoing discussion on CPU models and topology
 * Document at a higher level than just domain XML
 
 To be completed until Friday, Sep 17.
@@ -91,7 +91,16 @@
 
 === Character devices ===
 
-FIXME awaiting input from QA
+Devices vmchannel and serial are supported
+
+Back ends stdio, file, null, unix, tcp are supported.  Back end spicevmc is for internal use only.
+
+Element domain
+    Element devices
+    Elements serial, channel
+        Attribute type
+	Supported values: stdio, file, null, unix, tcp
+	Internal use: spicevmc
 
 === Sound devices ===

    Technical note updated. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    Diffed Contents:
@@ -1,7 +1,7 @@
 This is a draft.  Holes:
 
-* Ongoing discussion on CPU models and topology
-* Document at a higher level than just domain XML
+* Ongoing discussion on CPU topology
+* Would be nice to document this at a higher level than just domain XML, but we're out of time
 
 To be completed until Friday, Sep 17.
 
@@ -15,10 +15,20 @@
 
 === CPU model and topology ===
 
-Configuration must result in a virtual CPU and topology that matches a supported physical CPU and topology.
+Virtual CPU models Opteron_G3, Opteron_G2, Opteron_G1, Nehalem, Penryn, Conroe, cpu64-rhel5, cpu64-rhel6 are supported.
 
+Exposing additional features of the host CPU is supported.
+
+Placing restrictions on acceptable host CPUs is supported.
+
 Element domain
     Element cpu
+        Element model
+	Supported contents: Opteron_G3, Opteron_G2, Opteron_G1, 		  	    Nehalem, Penryn, Conroe,
+			    cpu64-rhel5, cpu64-rhel6
+	Element feature
+	    Attribute policy
+	    Supported values: require, optional, forbid
 
 === Guest ACPI ===

    Technical note updated. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    Diffed Contents:
@@ -24,7 +24,8 @@
 Element domain
     Element cpu
         Element model
-	Supported contents: Opteron_G3, Opteron_G2, Opteron_G1, 		  	    Nehalem, Penryn, Conroe,
+	Supported contents: Opteron_G3, Opteron_G2, Opteron_G1,
+			    Nehalem, Penryn, Conroe,
 			    cpu64-rhel5, cpu64-rhel6
 	Element feature
 	    Attribute policy

    Technical note updated. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    Diffed Contents:
@@ -1,9 +1,4 @@
-This is a draft.  Holes:
-
-* Ongoing discussion on CPU topology
-* Would be nice to document this at a higher level than just domain XML, but we're out of time
-
-To be completed until Friday, Sep 17.
+Note: it would be nice to document this at a higher level than just domain XML, but we're out of time.
 
 === Hypervisor type ===

    Technical note updated. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    Diffed Contents:
@@ -94,6 +94,7 @@
 	    Element model
 	        Attribute type
 		Supported values: vga, cirrus, qxl
+qxl and spice are only supported under rhev-m and not through direct/libvirt invocation.
 
 === Character devices ===

In the light of this comment:
https://bugzilla.redhat.com/show_bug.cgi?id=634607#c5
I think we should note that for RHEL 6.0, IB700 is NOT
supported.

We may want to support it in RHEL 6.1.

    Technical note updated. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    Diffed Contents:
@@ -116,5 +116,15 @@
 Element domain
     Element devices
         Element sound
-        Attribute model
+            Attribute model
-        Supported values: es1370, ac97+            Supported values: es1370, ac97
+
+=== Watchdog devices ===
+
+Watchdog device i6300esb is supported.
+
+Element domain
+    Element devices
+        Element watchdog
+	    Attribute model
+	    Supported value: i6300esb