Index: bhyve.8 =================================================================== --- bhyve.8 +++ bhyve.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd February 27, 2017 +.Dd March 15, 2017 .Dt BHYVE 8 .Os .Sh NAME @@ -188,6 +188,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 +303,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. @@ -389,6 +421,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 +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 ,