7:54 a.m.
The vram attribute was introduced to set the video memory but it is
usable only for few hypervisors excluding QEMU/KVM. QEMU/KVM has
different attribute for this purpose "vgamem_mb" and it will be
introduced lately.
The correct usage of vram is to set the video memory for other
hypervisors or to set secondary bar size for QXL video device for
QEMU/KVM.
This patch updates the documentation to reflect current code in libvirt
and also changes the cases when we will set the default vram attribute.
It's pointless to set it for QEMU/KVM if you aren't using QXL as it
won't be used.
Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1076098
Signed-off-by: Pavel Hrdina <phrdina(a)redhat.com>
---
docs/formatdomain.html.in | 62 +++++++++++++++++++++++++++++------------------
src/conf/domain_conf.c | 19 ++++++++++++---
src/conf/domain_conf.h | 3 ++-
src/qemu/qemu_command.c | 4 +--
4 files changed, 58 insertions(+), 30 deletions(-)
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index d4189e6..2bbd389 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -4658,33 +4658,49 @@ qemu-kvm -net nic,model=? /dev/null
<dl>
<dt><code>video</code></dt>
<dd>
- The <code>video</code> element is the container for describing
- video devices. For backwards compatibility, if no <code>video</code>
- is set but there is a <code>graphics</code> in domain xml, then
libvirt
- will add a default <code>video</code> according to the guest type.
- For a guest of type "kvm", the default <code>video</code>
for it is:
- <code>type</code> with value "cirrus",
<code>vram</code> with value
- "9216", and <code>heads</code> with value "1". By
default, the first
- video device in domain xml is the primary one, but the optional
- attribute <code>primary</code> (<span
class="since">since 1.0.2</span>)
- with value 'yes' can be used to mark the primary in cases of multiple
- video device. The non-primary must be type of "qxl". The optional
- attribute <code>ram</code> (<span
class="since">since
- 1.0.2</span>) is allowed for "qxl" type only and specifies
- the size of the primary bar, while <code>vram</code> specifies the
- secondary bar size. If "ram" or "vram" are not supplied a
default
- value is used.
+ <p>
+ The <code>video</code> element is the container for describing
+ video devices. For backwards compatibility, if no
<code>video</code>
+ is set but there is a <code>graphics</code> in domain xml, then
+ libvirt will add a default <code>video</code> according to the
guest
+ type.
+ </p>
+ <p>
+ For a guest of type "kvm", the default <code>video</code>
is:
+ <code>type</code> with value "cirrus",
<code>vram</code> with value
+ "9216" and <code>heads</code> with value "1".
By default, the first
+ video device in domain xml is the primary one, but the optional
+ attribute <code>primary</code> (<span
class="since">since 1.0.2</span>)
+ with value 'yes' can be used to mark the primary in cases of multiple
+ video device. The non-primary must be type of "qxl".
+ </p>
</dd>
<dt><code>model</code></dt>
<dd>
- The <code>model</code> element has a mandatory
<code>type</code>
- attribute which takes the value "vga", "cirrus",
"vmvga", "xen",
- "vbox", or "qxl" (<span class="since">since
0.8.6</span>)
- depending on the hypervisor features available.
- You can also provide the amount of video memory in kibibytes
- (blocks of 1024 bytes) using
- <code>vram</code> and the number of screen with
<code>heads</code>.
+ <p>
+ The <code>model</code> element has a mandatory
<code>type</code>
+ attribute which takes the value "vga", "cirrus",
"vmvga", "xen",
+ "vbox", or "qxl" (<span class="since">since
0.8.6</span>) depending
+ on the hypervisor features available.
+ </p>
+ <p>
+ You can provide the amount of video memory in kibibytes (blocks of
+ 1024 bytes) using <code>vram</code>. This is supported only for
guest
+ type of "libxl", "parallels", "qemu",
"vbox", "vmx" and "xen". If no
+ value is provided the default is used.
+ </p>
+ <p>
+ The number of screen can be set using <code>heads</code>. This is
+ supported only for guests type of "parallels", "kvm",
"vbox" and "vmx".
+ </p>
+ <p>
+ For guest type of kvm the optional attribute <code>ram</code>
+ (<span class="since">since 1.0.2</span>) is allowed for
"qxl" type
+ only and specifies the size of the primary bar, while the optional
+ attribute <code>vram</code> specifies the secondary bar size.
+ If "ram" or "vram" are not supplied a default value is
used.
+ </p>
</dd>
<dt><code>acceleration</code></dt>
diff --git a/src/conf/domain_conf.c b/src/conf/domain_conf.c
index 2c65276..3a844b4 100644
--- a/src/conf/domain_conf.c
+++ b/src/conf/domain_conf.c
@@ -10099,9 +10099,9 @@ virSysinfoParseXML(xmlNodePtr node,
goto cleanup;
}
-int
+unsigned int
virDomainVideoDefaultRAM(const virDomainDef *def,
- int type)
+ const virDomainVideoType type)
{
/* Defer setting default vram to the Xen drivers */
if (def->virtType == VIR_DOMAIN_VIRT_XEN)
@@ -10278,11 +10278,22 @@ virDomainVideoDefParseXML(xmlNodePtr node,
if (vram) {
if (virStrToLong_ui(vram, NULL, 10, &def->vram) < 0) {
virReportError(VIR_ERR_XML_ERROR,
- _("cannot parse video ram '%s'"), vram);
+ _("cannot parse video vram '%s'"), vram);
goto error;
}
} else {
- def->vram = virDomainVideoDefaultRAM(dom, def->type);
+ switch (dom->virtType) {
+ case VIR_DOMAIN_VIRT_QEMU:
+ case VIR_DOMAIN_VIRT_KQEMU:
+ case VIR_DOMAIN_VIRT_KVM:
+ break;
+ default:
+ def->vram = virDomainVideoDefaultRAM(dom, def->type);
+ break;
+ }
+
+ if (def->type == VIR_DOMAIN_VIDEO_TYPE_QXL)
+ def->vram = virDomainVideoDefaultRAM(dom, def->type);
}
if (heads) {
diff --git a/src/conf/domain_conf.h b/src/conf/domain_conf.h
index 530a3ca..b6ea6e4 100644
--- a/src/conf/domain_conf.h
+++ b/src/conf/domain_conf.h
@@ -2606,7 +2606,8 @@ int virDomainFSIndexByName(virDomainDefPtr def, const char *name);
virDomainFSDefPtr virDomainFSRemove(virDomainDefPtr def, size_t i);
int virDomainVideoDefaultType(const virDomainDef *def);
-int virDomainVideoDefaultRAM(const virDomainDef *def, int type);
+unsigned int virDomainVideoDefaultRAM(const virDomainDef *def,
+ const virDomainVideoType type);
int virDomainObjListNumOfDomains(virDomainObjListPtr doms,
bool active,
diff --git a/src/qemu/qemu_command.c b/src/qemu/qemu_command.c
index f674ba9..fa7c365 100644
--- a/src/qemu/qemu_command.c
+++ b/src/qemu/qemu_command.c
@@ -9334,8 +9334,8 @@ qemuBuildCommandLine(virConnectPtr conn,
virQEMUCapsGet(qemuCaps, QEMU_CAPS_DEVICE)) {
const char *dev = (virQEMUCapsGet(qemuCaps,
QEMU_CAPS_DEVICE_QXL_VGA)
? "qxl-vga" : "qxl");
- int ram = def->videos[0]->ram;
- int vram = def->videos[0]->vram;
+ unsigned int ram = def->videos[0]->ram;
+ unsigned int vram = def->videos[0]->vram;
if (vram > (UINT_MAX / 1024)) {
virReportError(VIR_ERR_OVERFLOW,
--
2.0.4