Index: bhyve/bhyve.8 =================================================================== --- bhyve/bhyve.8 +++ bhyve/bhyve.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd February 27, 2017 +.Dd March 15, 2017 .Dt BHYVE 8 .Os .Sh NAME @@ -49,10 +49,13 @@ Parameters such as the number of virtual CPUs, amount of guest memory, and I/O connectivity can be specified with command-line parameters. .Pp -The guest operating system must be loaded with +If not using boot ROM, the guest operating system must be loaded with .Xr bhyveload 8 or a similar boot loader before running -.Nm . +.Nm , +otherwise it is enough to run +.Nm +with a boot ROM of choice. .Pp .Nm runs until the guest operating system reboots or an unhandled hypervisor @@ -188,6 +191,10 @@ .It Li lpc LPC PCI-ISA bridge with COM1 and COM2 16550 serial ports and a boot ROM. The LPC bridge emulation can only be configured on bus 0. +.It Li fbuf +Framebuffer device. +.It Li xhci +eXtensible Host Controller Interface (xHCI) USB controller. .El .It Op Ar conf This optional parameter describes the backend for device emulations. @@ -299,6 +306,34 @@ Emergency write is advertised, but no-op as of now. .El .El +.Pp +Framebuffer devices: +.Bl -tag -width 10n +.It tcp= Ns Ar host:port Ns Op , Ns w= Ns Ar width Ns ,h= Ns Ar height Ns Op , Ns wait +.Bl -tag -width 8n +.It Ar host:port +A +.Ar host +and a +.Ar port +VNC should listen on. +.It Ar width No and Ar height +A display resolution, width and height, respectively. +.It wait +Instruct +.Nm +to only boot upon the initiation of a VNC connection, simplifying the installation +of operating systems that require immediate keyboard input. +This can be removed for post-installation use. +.El +.El +.Pp +xHCI USB devices: +.Bl -tag -width 10n +.It Li tablet +A USB tablet device which provides precise cursor synchronization +when using VNC. +.El .El .It Fl S Wire guest memory. @@ -347,11 +382,12 @@ triple fault .El .Sh EXAMPLES -The guest operating system must have been loaded with +If not using boot ROM, the guest operating system must have been loaded with .Xr bhyveload 8 or a similar boot loader before .Xr bhyve 4 can be run. +Otherwise boot loader is not needed. .Pp To run a virtual machine with 1GB of memory, two virtual CPUs, a virtio block device backed by the @@ -389,6 +425,21 @@ -l com1,/dev/nmdm0A \\ -A -H -P -m 8G .Ed +.Pp +Run an UEFI virtual machine with a display resolution of 800 by 600 pixels +that can be accessed via VNC at: 0.0.0.0:5900. +.Bd -literal -offset indent +bhyve -c 2 -m 4G -w -H \\ + -s 0,hostbridge \\ + -s 3,ahci-cd,/path/to/uefi-OS-install.iso \\ + -s 4,ahci-hd,disk.img \\ + -s 5,virtio-net,tap0 \\ + -s 29,fbuf,tcp=0.0.0.0:5900,w=800,h=600,wait \\ + -s 30,xhci,tablet \\ + -s 31,lpc -l com1,stdio \\ + -l bootrom,/usr/local/share/uefi-firmware/BHYVE_UEFI.fd \\ + uefivm +.Ed .Sh SEE ALSO .Xr bhyve 4 , .Xr nmdm 4 ,