Attachment 180902 Details for Bug 215762 – Updated patch

[patch] Updated patch

framebuffer.diff (text/plain), 5.51 KB, created by Benedict Reuschling on 2017-03-17 13:42:30 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Benedict Reuschling

Created: 2017-03-17 13:42:30 UTC

Size: 5.51 KB

patch

obsolete

>Index: en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
>===================================================================
>--- en_US.ISO8859-1/books/handbook/virtualization/chapter.xml	(revision 50065)
>+++ en_US.ISO8859-1/books/handbook/virtualization/chapter.xml	(working copy)
>@@ -91,7 +91,7 @@
> 
>       <listitem>
> 	<para>Know how to <link linkend="ports">install additional
>-	    third-party software</link>.</para>
>+	   third-party software</link>.</para>
>       </listitem>
>     </itemizedlist>
>   </sect1>
>@@ -971,9 +971,9 @@
>       <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,81 @@
>       <screen>&prompt.root; <userinput>bhyvectl --destroy --vm=<replaceable>linuxguest</replaceable></userinput></screen>
>     </sect2>
> 
>+    <sect2 xml:id="virtualization-bhyve-uefi">
>+      <title>Booting <application>bhyve</application> Virtual Machines
>+	with <acronym>UEFI</acronym> Firmware</title>
>+
>+      <para>In addition to <application>bhyveload</application> and
>+	<application>grub-bhyve</application>, the
>+	<application>bhyve</application> hypervisor can also boot
>+	virtual machines using <acronym>UEFI</acronym> userspace
>+	firmware.  This option may support guest operating systems
>+	that are not supported by the other loaders.</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 <acronym>UEFI</acronym> Framebuffer for
>+	<application>bhyve</application> Guests</title>
>+
>+      <para><acronym>UEFI</acronym> firmware support is particularly
>+	useful with predominantly graphical guest operating systems
>+	such as Microsoft &windows;.</para>
>+
>+      <para>Support for the UEFI-GOP framebuffer may also be enabled
>+	with the <option>-s 29,fbuf,tcp=<replaceable>0.0.0.0:5900</replaceable></option>
>+	flags.  The framebuffer resolution may be configured with
>+	<option>w=<replaceable>800</replaceable></option> and
>+	<option>h=<replaceable>600</replaceable></option>, and
>+	<application>bhyve</application> can be instructed to wait for
>+	a <acronym>VNC</acronym> connection before booting the VM by
>+	adding <option>wait</option>.  The framebuffer may be accessed
>+	from the host or over the network via <acronym>VNC</acronym>
>+	protocol.</para>
>+
>+      <para>The resulting <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
>+	receiving 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>

Actions: View | Diff

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