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.

+

Guest usage / management

=20

Connecting to a guest console

@@ -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 +

Using UEFI bootrom, VNC, and USB tables

+ +

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.

+

Clock configuration

=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