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 <application>bhyve</application> Virtual Machines + with <acronym>UEFI</acronym> 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 <acronym>UEFI</acronym> Framebuffer for + <application>bhyve</application> 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 <acronym>ZFS</acronym> with <application>bhyve</application> Guests