From nobody Sun Apr 28 08:00:16 2024
Delivered-To: importer@patchew.org
Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28
as permitted sender) client-ip=209.132.183.28;
envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com;
Authentication-Results: mx.zoho.com;
dkim=fail
spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as
permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com;
Return-Path:
Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by
mx.zohomail.com
with SMTPS id 1490632452759220.5990310733622;
Mon, 27 Mar 2017 09:34:12 -0700 (PDT)
Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com
[10.5.11.13])
(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
(No client certificate requested)
by mx1.redhat.com (Postfix) with ESMTPS id 705B87FD52;
Mon, 27 Mar 2017 16:34:11 +0000 (UTC)
Received: from colo-mx.corp.redhat.com (unknown [10.5.11.21])
by smtp.corp.redhat.com (Postfix) with ESMTPS id 28A9681C0F;
Mon, 27 Mar 2017 16:34:11 +0000 (UTC)
Received: from lists01.pubmisc.prod.ext.phx2.redhat.com
(lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33])
by colo-mx.corp.redhat.com (Postfix) with ESMTP id D6C505EC62;
Mon, 27 Mar 2017 16:34:10 +0000 (UTC)
Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com
[10.5.11.11])
by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP
id v2RGY9RM020172 for ;
Mon, 27 Mar 2017 12:34:09 -0400
Received: by smtp.corp.redhat.com (Postfix)
id E15E288695; Mon, 27 Mar 2017 16:34:09 +0000 (UTC)
Received: from mx1.redhat.com (ext-mx05.extmail.prod.ext.phx2.redhat.com
[10.5.110.29])
by smtp.corp.redhat.com (Postfix) with ESMTPS id DA38118A34
for ; Mon, 27 Mar 2017 16:34:02 +0000 (UTC)
Received: from mail-lf0-f66.google.com (mail-lf0-f66.google.com
[209.85.215.66])
(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
(No client certificate requested)
by mx1.redhat.com (Postfix) with ESMTPS id 289BE37E64
for ; Mon, 27 Mar 2017 16:34:00 +0000 (UTC)
Received: by mail-lf0-f66.google.com with SMTP id x137so7892942lff.1
for ; Mon, 27 Mar 2017 09:34:00 -0700 (PDT)
Received: from kloomba.my.domain ([31.29.231.57])
by smtp.gmail.com with ESMTPSA id x84sm205346lfa.13.2017.03.27.09.33.57
(version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
Mon, 27 Mar 2017 09:33:57 -0700 (PDT)
DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com 705B87FD52
Authentication-Results: ext-mx03.extmail.prod.ext.phx2.redhat.com;
dmarc=fail (p=none dis=none) header.from=gmail.com
Authentication-Results: ext-mx03.extmail.prod.ext.phx2.redhat.com;
spf=pass smtp.mailfrom=libvir-list-bounces@redhat.com
DKIM-Filter: OpenDKIM Filter v2.11.0 mx1.redhat.com 705B87FD52
Authentication-Results: mx1.redhat.com;
dkim=fail reason="signature verification failed" (2048-bit key)
header.d=gmail.com header.i=@gmail.com header.b="oWWhAHrP"
DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com 289BE37E64
Authentication-Results: ext-mx05.extmail.prod.ext.phx2.redhat.com;
dmarc=pass (p=none dis=none) header.from=gmail.com
Authentication-Results: ext-mx05.extmail.prod.ext.phx2.redhat.com;
spf=pass smtp.mailfrom=bogorodskiy@gmail.com
DKIM-Filter: OpenDKIM Filter v2.11.0 mx1.redhat.com 289BE37E64
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
h=from:to:cc:subject:date:message-id;
bh=fqSO2WTe3yyDtmJ28nJ/4gLz7S+ygRsoFR+KVXguiws=;
b=oWWhAHrP/NmmYDs2cpYSCucT3Pz1G6IgsY2GO95XLHArmAOsO9DX81GQlwsGC020Hm
012gZ3pvClpgzvdgrG8La6Qm+phsaURTwgKsDBHQtHF3Bk9bFqCdLNCndvBC7f2qL9pL
gsCXruBkXx7R+YeigQU8fH/NRW65ZMs/emTHxg7QaYMx2hAc2PtcXbtWejIjrWUOsGCp
dZ6gtdjX3sQ2gCw9ZzGCelgcoWSX5F9hG9F5B6bJHyLpIrP29zS4JG/bXD7YOGJj0IPO
Y//oQ9HxcyWfE1ueMsKGliJaDw7VwuQ8zt1mPps8vcVBSYVBRNhJxVdMeQ7wi3gmODg1
nZyQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20161025;
h=x-gm-message-state:from:to:cc:subject:date:message-id;
bh=fqSO2WTe3yyDtmJ28nJ/4gLz7S+ygRsoFR+KVXguiws=;
b=e8iKL5hSc5zuGmVtFAvynAm0Q0I+ED2DG23TZOEPHExfGTBsKDBICO3ZgIEjzWHbxe
ytTXNmGxg1Tct/n+ou/RO5vN7tpEEREXAldmcufE7u7q317QFV4CNdEY1Jnh8m4CBhHk
qyZNdM6PtHNDWdkCy4QHfqO1RauQTPYTBqRZJ5Z5DW63i79RSwUqPqHQRmlLryGJUgbp
gPT1K7W10r8qWLK4h93Da0MnA7ms+6fHTJ9Efd4mRyqX3a4VL9ntyPXm7qAgYVGoH9uU
5SwjIlHsZzZgbSvSvuLglRBw/LMt/yIpX/+5xNu/f2G32PmjejsY1tB/8QLyBYf6kFJ8
f/FA==
X-Gm-Message-State:
AFeK/H3Gl9yMI5/yQppKjlRM18ZjRWAlEU+2O2AUNJ7tJhiZG9HMoRY9f83ZK5bXmlwf8g==
X-Received: by 10.25.213.140 with SMTP id m134mr11463461lfg.171.1490632438249;
Mon, 27 Mar 2017 09:33:58 -0700 (PDT)
From: Roman Bogorodskiy
To: libvir-list@redhat.com
Date: Mon, 27 Mar 2017 20:33:52 +0400
Message-Id: <20170327163352.25127-1-bogorodskiy@gmail.com>
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16
(mx1.redhat.com [10.5.110.29]);
Mon, 27 Mar 2017 16:34:00 +0000 (UTC)
X-Greylist: inspected by milter-greylist-4.5.16 (mx1.redhat.com
[10.5.110.29]);
Mon, 27 Mar 2017 16:34:00 +0000 (UTC) for IP:'209.85.215.66'
DOMAIN:'mail-lf0-f66.google.com' HELO:'mail-lf0-f66.google.com'
FROM:'bogorodskiy@gmail.com' RCPT:''
X-RedHat-Spam-Score: 1.17 * (BAYES_50, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU,
FREEMAIL_FROM, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H3,
RCVD_IN_MSPIKE_WL, RCVD_IN_SORBS_SPAM,
SPF_PASS) 209.85.215.66 mail-lf0-f66.google.com 209.85.215.66
mail-lf0-f66.google.com
X-Scanned-By: MIMEDefang 2.78 on 10.5.110.29
X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11
X-loop: libvir-list@redhat.com
Cc: Roman Bogorodskiy
Subject: [libvirt] [PATCH] docs: document bhyve UEFI support
X-BeenThere: libvir-list@redhat.com
X-Mailman-Version: 2.1.12
Precedence: junk
List-Id: Development discussions about the libvirt library & tools
List-Unsubscribe: ,
List-Archive:
List-Post:
List-Help:
List-Subscribe: ,
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
Sender: libvir-list-bounces@redhat.com
Errors-To: libvir-list-bounces@redhat.com
X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13
X-Greylist: Sender IP whitelisted,
not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.27]);
Mon, 27 Mar 2017 16:34:12 +0000 (UTC)
X-ZohoMail-DKIM: fail (Header signature does not verify)
X-ZohoMail: RDKM_2 RSF_0 Z_629925259 SPT_0
Content-Type: text/plain; charset="utf-8"
- Add a news entry
- Update the driver page with documentation of the new options
and some examples
---
docs/drvbhyve.html.in | 94 +++++++++++++++++++++++++++++++++++++++++++++++=
++++
docs/news.xml | 13 +++++++
2 files changed, 107 insertions(+)
diff --git a/docs/drvbhyve.html.in b/docs/drvbhyve.html.in
index 64a1ff694..0aed121ff 100644
--- a/docs/drvbhyve.html.in
+++ b/docs/drvbhyve.html.in
@@ -155,6 +155,57 @@ Note the addition of <bootloader>.
</domain>
=20
+Example config (Linux UEFI guest, VNC, tablet)
+
+This is an example to boot into Fedora 25 installation:
+
+
+<domain type=3D'bhyve'>
+ <name>fedora_uefi_vnc_tablet</name>
+ <memory unit=3D'G'>4</memory>
+ <vcpu>2</vcpu>
+ <os>
+ <type>hvm</type>
+ <loader readonly=3D"yes" type=3D"pflash"&=
gt;/usr/local/share/uefi-firmware/BHYVE_UEFI.fd</loader>
+ </os>
+ <features>
+ <apic/>
+ <acpi/>
+ </features>
+ <clock offset=3D'utc'/>
+ <on_poweroff>destroy</on_poweroff>
+ <on_reboot>restart</on_reboot>
+ <on_crash>destroy</on_crash>
+ <devices>
+ <disk type=3D'file' device=3D'cdrom'>
+ <driver name=3D'file' type=3D'raw'/>
+ <source file=3D'/path/to/Fedora-Workstation-Live-x86_64-25-1.=
3.iso'/>
+ <target dev=3D'hdc' bus=3D'sata'/>
+ <readonly/>
+ </disk>
+ <disk type=3D'file' device=3D'disk'>
+ <driver name=3D'file' type=3D'raw'/>
+ <source file=3D'/path/to/linux_uefi.img'/>
+ <target dev=3D'hda' bus=3D'sata'/>
+ </disk>
+ <interface type=3D'bridge'>
+ <model type=3D'virtio'/>
+ <source bridge=3D"virbr0"/>
+ </interface>
+ <serial type=3D"nmdm">
+ <source master=3D"/dev/nmdm0A" slave=3D"/dev/nmd=
m0B"/>
+ </serial>
+ <graphics type=3D'vnc' port=3D'5904'>
+ <listen type=3D'address' address=3D'127.0.0.1'/>
+ </graphics>
+ <controller type=3D'usb' model=3D'nec-xhci'/>
+ <input type=3D'tablet' bus=3D'usb'/>
+ </devices>
+</domain>
+
+
+Please refer to the UEFI section for a more detai=
led explanation.
+
=20
@@ -261,6 +312,49 @@ attempt to boot from the first partition in the disk i=
mage.
Caveat: bootloader_args
does not support any quoting.
Filenames, etc, must not have spaces or they will be tokenized incorrectly=
.
=20
+
+
+Since 3.2.0, in addition to grub-bhyve,
+non-FreeBSD guests could be also booted using an UEFI boot ROM, provided b=
oth guest OS and
+installed bhyve(1)
version support UEFI. To use that, l=
oader
+should be specified in the os
section:
+
+
+<domain type=3D'bhyve'>
+ ...
+ <os>
+ <type>hvm</type>
+ <loader readonly=3D"yes" type=3D"pflash">/usr/local/share/uef=
i-firmware/BHYVE_UEFI.fd</loader>
+ </os>
+ ...
+
+
+This uses the UEFI firmware provided by
+the sysuti=
ls/bhyve-firmware
+FreeBSD port.
+
+VNC and the tablet input device could be configured this way:
+
+
+<domain type=3D'bhyve'>
+ <devices>
+ ...
+ <graphics type=3D'vnc' port=3D'5904'>
+ <listen type=3D'address' address=3D'127.0.0.1'/>
+ </graphics>
+ <controller type=3D'usb' model=3D'nec-xhci'/>
+ <input type=3D'tablet' bus=3D'usb'/>
+ </devices>
+ ...
+</domain>
+
+
+This way, VNC will be accessible on 127.0.0.1:5904
.
+
+Please note that the tablet device requires to have an USB controller
+of the nec-xhci
model. Currently, only a single controller of=
this
+type and a single tablet are supported per domain.
+
=20
Originally bhyve supported only localtime for RTC. Support for UTC time=
was introduced in
diff --git a/docs/news.xml b/docs/news.xml
index 814bd93fd..0db9813d7 100644
--- a/docs/news.xml
+++ b/docs/news.xml
@@ -70,6 +70,19 @@
introducing a new host device type in the XML.
+
+
+ bhyve: Add support for UEFI boot ROM, VNC, and USB tablet
+
+
+ The bhyve driver now supports booting using the UEFI boot ROM,
+ so non-FreeBSD guests that support UEFI could be booted without
+ using an external boot loader like grub-bhyve. Video is also
+ supported now, allowing to connect to guests via VNC and use
+ an USB tablet as an input device. Please refer to
+ the driver page for domain XML examples.
+
+
--=20
2.11.0
--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list