Attachment 178502 Details for Bug 215762 – Git patch against current handbook source

[patch] Git patch against current handbook source

0001-Add-information-about-UEFI-emulation-in-BHyVe.patch (text/plain), 5.51 KB, created by Dmitrij D. Czarkoff on 2017-01-04 12:05:32 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Dmitrij D. Czarkoff

Created: 2017-01-04 12:05:32 UTC

Size: 5.51 KB

patch

obsolete

>From 7e5f2e6e851f2c074f172da3ced2c037faace5d2 Mon Sep 17 00:00:00 2001
>From: "Dmitrij D. Czarkoff" <czarkoff@surely.youdontcare.com>
>Date: Tue, 3 Jan 2017 15:11:28 +0100
>Subject: [PATCH] Add information about UEFI emulation in BHyVe
>
>---
> .../books/handbook/virtualization/chapter.xml      | 78 +++++++++++++++++++++-
> 1 file changed, 75 insertions(+), 3 deletions(-)
>
>diff --git a/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml b/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
>index e484ad5458..7eb18fba96 100644
>--- a/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
>+++ b/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
>@@ -971,9 +971,9 @@ perm pass* 0660</programlisting>
>       <acronym>BSD</acronym>-licensed hypervisor became part of the
>       base system with &os; 10.0-RELEASE.  This hypervisor supports a
>       number of guests, including &os;, OpenBSD, and many &linux;
>-      distributions.  Currently, <application>bhyve</application> only
>-      supports a serial console and does not emulate a graphical
>-      console.  Virtualization offload features of newer
>+      distributions.  By default, <application>bhyve</application>
>+      provides access to serial console and does not emulate a
>+      graphical console.  Virtualization offload features of newer
>       <acronym>CPU</acronym>s are used to avoid the legacy methods of
>       translating instructions and manually managing memory
>       mappings.</para>
>@@ -1175,6 +1175,78 @@ grub> <userinput>boot</userinput></screen>
>       <screen>&prompt.root; <userinput>bhyvectl --destroy --vm=<replaceable>linuxguest</replaceable></userinput></screen>
>     </sect2>
> 
>+    <sect2 xml:id="virtualization-bhyve-uefi">
>+      <title>Using <acronym>UEFI</acronym> with
>+	<application>bhyve</application> Guests</title>
>+
>+      <para><acronym>UEFI</acronym> support may come handy with
>+	guest operating systems which are not directly supported
>+	by FreeBSD bootloader or GRUB.</para>
>+
>+      <para>In order to make use of <acronym>UEFI</acronym> support
>+	in <application>bhyve</application>, first obtain the
>+	<acronym>UEFI</acronym> firmware images.  This can be done
>+	by installing <package>sysutils/bhyve-firmware</package>
>+	port.</para>
>+
>+      <para>With firmware in place, add
>+	<option>-l bootrom,<replaceable>/path/to/firmware</replaceable></option>
>+	flags to your <application>bhyve</application> command line.
>+	The actual <application>bhyve</application> command may look
>+	like this:</para>
>+
>+      <screen>&prompt.root; <userinput>bhyve -AHP -s 0:0,hostbridge -s 1:0,lpc \
>+    -s 2:0,virtio-net,<replaceable>tap1</replaceable> -s 3:0,virtio-blk,<replaceable>./disk.img</replaceable> \
>+    -s 4:0,ahci-cd,<replaceable>./install.iso</replaceable> -c <replaceable>4</replaceable> -m <replaceable>1024M</replaceable> \
>+    -l bootrom,<replaceable>/usr/local/share/uefi-firmware/BHYVE_UEFI.fd</replaceable> \
>+    <replaceable>guest</replaceable></userinput></screen>
>+
>+      <para><package>sysutils/bhyve-firmware</package> also contains
>+	a <acronym>CSM</acronym>-enabled firmware, so guests with no
>+	<acronym>UEFI</acronym> support may be booted in legacy
>+	<acronym>BIOS</acronym> mode:</para>
>+
>+      <screen>&prompt.root; <userinput>bhyve -AHP -s 0:0,hostbridge -s 1:0,lpc \
>+    -s 2:0,virtio-net,<replaceable>tap1</replaceable> -s 3:0,virtio-blk,<replaceable>./disk.img</replaceable> \
>+    -s 4:0,ahci-cd,<replaceable>./install.iso</replaceable> -c <replaceable>4</replaceable> -m <replaceable>1024M</replaceable> \
>+    -l bootrom,<replaceable>/usr/local/share/uefi-firmware/BHYVE_UEFI_CSM.fd</replaceable> \
>+    <replaceable>guest</replaceable></userinput></screen>
>+    </sect2>
>+
>+    <sect2 xml:id="virtualization-bhyve-framebuffer">
>+      <title>Graphical framebuffer for
>+	<application>bhyve</application> Guests</title>
>+
>+      <para><acronym>UEFI</acronym> support may come particularly
>+	handy with predominantly graphical guest operating systems
>+	like &windows;.</para>
>+
>+      <para> Support for framebuffer may also be enabled with
>+	<option>-s 29,fbuf,tcp=<replaceable>0.0.0.0:5900</replaceable></option>
>+	flags.  Framebuffer size may be configured with
>+	<option>w=<replaceable>800</replaceable></option> and
>+	<option>h=<replaceable>600</replaceable></option>, and
>+	<application>bhyve</application> may be instructed to wait
>+	for <acronym>VNC</acronym> connection before running the
>+	firmware by adding option <option>wait</option>.  The
>+	framebuffer may be accessed from host or over network via
>+	<acronym>VNC</acronym> protocol.</para>
>+
>+      <para>Thus, <application>bhyve</application> command may look
>+	like this:</para>
>+
>+      <screen>&prompt.root; <userinput>bhyve -AHP -s 0:0,hostbridge -s 31:0,lpc \
>+    -s 2:0,virtio-net,<replaceable>tap1</replaceable> -s 3:0,virtio-blk,<replaceable>./disk.img</replaceable> \
>+    -s 4:0,ahci-cd,<replaceable>./install.iso</replaceable> -c <replaceable>4</replaceable> -m <replaceable>1024M</replaceable> \
>+    -s 29,fbuf,tcp=<replaceable>0.0.0.0:5900</replaceable>,w=<replaceable>800</replaceable>,h=<replaceable>600</replaceable>,wait \
>+    -l bootrom,<replaceable>/usr/local/share/uefi-firmware/BHYVE_UEFI.fd</replaceable> \
>+    <replaceable>guest</replaceable></userinput></screen>
>+
>+      <para>Note, in BIOS emulation mode the framebuffer will cease
>+	recieving updates once control is passed from firmware to
>+	guest operating system.</para>
>+    </sect2>
>+
>     <sect2 xml:id="virtualization-bhyve-zfs">
>       <title>Using <acronym>ZFS</acronym> with
> 	<application>bhyve</application> Guests</title>
>-- 
>2.11.0
>

Actions: View | Diff

Attachments on bug 215762: 178502 | 180895 | 180902 | 181063