diff --git a/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml b/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
index a1022e603f..f7d4f66b84 100644
--- a/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
@@ -91,7 +91,7 @@
Know how to install additional
- third-party software.
+ third-party software.
@@ -971,9 +971,9 @@ perm pass* 0660
BSD-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, bhyve only
- supports a serial console and does not emulate a graphical
- console. Virtualization offload features of newer
+ distributions. By default, bhyve
+ provides access to serial console and does not emulate a
+ graphical console. Virtualization offload features of newer
CPUs are used to avoid the legacy methods of
translating instructions and manually managing memory
mappings.
@@ -1175,6 +1175,81 @@ grub> boot&prompt.root; bhyvectl --destroy --vm=linuxguest
+
+ Booting bhyve Virtual Machines
+ with UEFI Firmware
+
+ In addition to bhyveload and
+ grub-bhyve, the
+ bhyve hypervisor can also boot
+ virtual machines using the UEFI userspace
+ firmware. This option may support guest operating systems
+ that are not supported by the other loaders.
+
+ In order to make use of the UEFI
+ support in bhyve, first obtain the
+ UEFI firmware images. This can be done
+ by installing sysutils/bhyve-firmware
+ port or package.
+
+ With the firmware in place, add the flags
+
+ to your bhyve command line.
+ The actual bhyve command may look
+ like this:
+
+ &prompt.root; bhyve -AHP -s 0:0,hostbridge -s 1:0,lpc \
+-s 2:0,virtio-net,tap1 -s 3:0,virtio-blk,./disk.img \
+-s 4:0,ahci-cd,./install.iso -c 4 -m 1024M \
+-l bootrom,/usr/local/share/uefi-firmware/BHYVE_UEFI.fd \
+guest
+
+ sysutils/bhyve-firmware also contains a
+ CSM-enabled firmware, to boot guests with no
+ UEFI support in legacy
+ BIOS mode:
+
+ &prompt.root; bhyve -AHP -s 0:0,hostbridge -s 1:0,lpc \
+-s 2:0,virtio-net,tap1 -s 3:0,virtio-blk,./disk.img \
+-s 4:0,ahci-cd,./install.iso -c 4 -m 1024M \
+-l bootrom,/usr/local/share/uefi-firmware/BHYVE_UEFI_CSM.fd \
+guest
+
+
+
+ Graphical UEFI Framebuffer for
+ bhyve Guests
+
+ The UEFI firmware support is particularly
+ useful with predominantly graphical guest operating systems
+ such as Microsoft &windows;.
+
+ Support for the UEFI-GOP framebuffer may also be enabled
+ with the
+ flags. The framebuffer resolution may be configured with
+ and
+ , and
+ bhyve can be instructed to wait for
+ a VNC connection before booting the guest
+ by adding . The framebuffer may be
+ accessed from the host or over the network via the
+ VNC protocol.
+
+ The resulting bhyve command
+ would look like this:
+
+ &prompt.root; bhyve -AHP -s 0:0,hostbridge -s 31:0,lpc \
+-s 2:0,virtio-net,tap1 -s 3:0,virtio-blk,./disk.img \
+-s 4:0,ahci-cd,./install.iso -c 4 -m 1024M \
+-s 29,fbuf,tcp=0.0.0.0:5900,w=800,h=600,wait \
+-l bootrom,/usr/local/share/uefi-firmware/BHYVE_UEFI.fd \
+guest
+
+ Note, in BIOS emulation mode, the framebuffer will cease
+ receiving updates once control is passed from firmware to
+ guest operating system.
+
+
Using ZFS with
bhyve Guests