RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.
Bug 620657 (unsupported) - Unsupported device uses need to be documented in release notes
Summary: Unsupported device uses need to be documented in release notes
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: unsupported
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: qemu-kvm
Version: 6.0
Hardware: All
OS: Linux
low
medium
Target Milestone: beta
: ---
Assignee: Markus Armbruster
QA Contact: Virtualization Bugs
URL:
Whiteboard:
Depends On:
Blocks: 580954
TreeView+ depends on / blocked
 
Reported: 2010-08-03 08:28 UTC by Markus Armbruster
Modified: 2013-01-09 22:58 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Note: it would be nice to document this at a higher level than just domain XML, but we're out of time. === Hypervisor type === Only KVM is supported. Element domain Attribute type Supported values: kvm === CPU model 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 === 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 qxl and spice are only supported under rhev-m and not through direct/libvirt invocation. === Character devices === 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 === Sound devices es1370 and ac97 are supported. Element domain Element devices Element sound Attribute model Supported values: es1370, ac97 === Watchdog devices === Watchdog device i6300esb is supported. Element domain Element devices Element watchdog Attribute model Supported value: i6300esb
Clone Of:
Environment:
Last Closed: 2010-11-21 22:15:23 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)

Description Markus Armbruster 2010-08-03 08:28:31 UTC 
We're going to ship with a number of devices enabled we won't support, and some we'll support only if used in certain ways, e.g. cold-plug only.  

Some of these uses are only possible via unsupported means, such as running qemu-kvm directly, or accessing the monitor directly.  No further documentation is required there.

Others are accessible via supported interfaces, such as libvirt's domain XML.  These need to be documented in the release notes.  This bug is meant to track that.
Comment 1 RHEL Program Management 2010-08-03 08:47:35 UTC 
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. **
Comment 2 Markus Armbruster 2010-08-03 09:05:51 UTC 
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
Comment 7 Markus Armbruster 2010-09-15 12:29:39 UTC 
    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
Comment 8 Markus Armbruster 2010-09-17 13:06:20 UTC 
    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 ===
Comment 9 Markus Armbruster 2010-09-17 16:57:48 UTC 
    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 ===
Comment 10 Markus Armbruster 2010-09-17 16:59:21 UTC 
    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
Comment 11 Markus Armbruster 2010-09-17 20:08:04 UTC 
    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 ===
Comment 12 Dor Laor 2010-09-22 09:06:40 UTC 
    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 ===
Comment 13 Richard W.M. Jones 2010-09-24 14:38:52 UTC 
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.
Comment 14 Markus Armbruster 2010-09-24 15:36:05 UTC 
    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
Note You need to log in before you can comment on or make changes to this bug.