From d975105c4813b56654a7a2f120207e7331d61475 Mon Sep 17 00:00:00 2001 From: Roman Bogorodskiy Date: Wed, 28 Jun 2017 20:23:52 +0400 Subject: [PATCH] docs: Document bhyve's vgaconf support - Add a news entry - Update driver's page with information about the new vgaconf attribute and provide usage example; while here, fix a grammar mistake Signed-off-by: Roman Bogorodskiy Reviewed-by: Andrea Bolognani --- docs/drvbhyve.html.in | 28 +++++++++++++++++++++++++++- docs/news.xml | 12 ++++++++++++ 2 files changed, 39 insertions(+), 1 deletion(-) diff --git a/docs/drvbhyve.html.in b/docs/drvbhyve.html.in index dd6620d59a..f083db91c5 100644 --- a/docs/drvbhyve.html.in +++ b/docs/drvbhyve.html.in @@ -351,10 +351,36 @@ FreeBSD port.

This way, VNC will be accessible on 127.0.0.1:5904.

-

Please note that the tablet device requires to have an USB controller +

Please note that the tablet device requires to have a USB controller of the nec-xhci model. Currently, only a single controller of this type and a single tablet are supported per domain.

+

Since 3.5.0, it's possible to configure how the video device is exposed +to the guest using the vgaconf attribute:

+ +
+<domain type='bhyve'>
+    <devices>
+    ...
+      <graphics type='vnc' port='5904'>
+        <listen type='address' address='127.0.0.1'/>
+      </graphics>
+      <video>
+        <driver vgaconf='on'/>
+        <model type='gop' heads='1' primary='yes'/>
+      </video>
+      ...
+    </devices>
+    ...
+</domain>
+
+ +

If not specified, bhyve's default mode for vgaconf +will be used. Please refer to the +bhyve(8) +manual page and the bhyve wiki for more details on using +the vgaconf option.

+

Clock configuration

Originally bhyve supported only localtime for RTC. Support for UTC time was introduced in diff --git a/docs/news.xml b/docs/news.xml index f4423a646c..933189484c 100644 --- a/docs/news.xml +++ b/docs/news.xml @@ -46,6 +46,18 @@ select a boot entry. + +

+ Support controlling how video devices are exposed to the bhyve guests + + + The vgaconf attribute was added to video's + driver element. Possible values are: on, + off, and io. It controlls the way how + bhyve exposes video devices to its guests; various guest OSes might + require different settings to boot properly. + +