[libvirt] [PATCH] docs: Document bhyve's vgaconf support

Roman Bogorodskiy posted 1 patch 6 years, 9 months ago
Patches applied successfully (tree, apply log)
git fetch https://github.com/patchew-project/libvirt tags/patchew/1498719209-31795-1-git-send-email-bogorodskiy@gmail.com
docs/drvbhyve.html.in | 28 +++++++++++++++++++++++++++-
docs/news.xml         | 12 ++++++++++++
2 files changed, 39 insertions(+), 1 deletion(-)
[libvirt] [PATCH] docs: Document bhyve's vgaconf support
Posted by Roman Bogorodskiy 6 years, 9 months ago
 - 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 <bogorodskiy@gmail.com>
---
 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 dd6620d..f083db9 100644
--- a/docs/drvbhyve.html.in
+++ b/docs/drvbhyve.html.in
@@ -351,10 +351,36 @@ FreeBSD port.</p>
 
 <p>This way, VNC will be accessible on <code>127.0.0.1:5904</code>.</p>
 
-<p>Please note that the tablet device requires to have an USB controller
+<p>Please note that the tablet device requires to have a USB controller
 of the <code>nec-xhci</code> model. Currently, only a single controller of this
 type and a single tablet are supported per domain.</p>
 
+<p><span class="since">Since 3.5.0</span>, it's possible to configure how the video device is exposed
+to the guest using the <code>vgaconf</code> attribute:</p>
+
+<pre>
+&lt;domain type='bhyve'&gt;
+    &lt;devices&gt;
+    ...
+      &lt;graphics type='vnc' port='5904'&gt;
+        &lt;listen type='address' address='127.0.0.1'/&gt;
+      &lt;/graphics&gt;
+      &lt;video&gt;
+        &lt;driver vgaconf='on'/&gt;
+        &lt;model type='gop' heads='1' primary='yes'/&gt;
+      &lt;/video&gt;
+      ...
+    &lt;/devices&gt;
+    ...
+&lt;/domain&gt;
+</pre>
+
+<p>If not specified, bhyve's default mode for <code>vgaconf</code>
+will be used. Please refer to the
+<a href="https://www.freebsd.org/cgi/man.cgi?query=bhyve&amp;sektion=8&amp;manpath=FreeBSD+12-current">bhyve(8)</a>
+manual page and the <a href="https://wiki.freebsd.org/bhyve">bhyve wiki</a> for more details on using
+the <code>vgaconf</code> option.</p>
+
 <h3><a name="clockconfig">Clock configuration</a></h3>
 
 <p>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 27562e1..d320965 100644
--- a/docs/news.xml
+++ b/docs/news.xml
@@ -46,6 +46,18 @@
           select a boot entry.
         </description>
       </change>
+      <change>
+        <summary>
+          Support controlling how video devices are exposed to the bhyve guests
+        </summary>
+        <description>
+          The <code>vgaconf</code> attribute was added to <code>video</code>'s
+          <code>driver</code> element. Possible values are: <code>on</code>,
+          <code>off</code>, and <code>io</code>. It controlls the way how
+          bhyve exposes video devices to its guests; various guest OSes might
+          require different settings to boot properly.
+        </description>
+      </change>
     </section>
     <section title="Improvements">
     </section>
-- 
2.7.4

--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list
Re: [libvirt] [PATCH] docs: Document bhyve's vgaconf support
Posted by Andrea Bolognani 6 years, 9 months ago
On Thu, 2017-06-29 at 10:53 +0400, Roman Bogorodskiy wrote:
>  - 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 <bogorodskiy@gmail.com>
> ---
>  docs/drvbhyve.html.in | 28 +++++++++++++++++++++++++++-
>  docs/news.xml         | 12 ++++++++++++
>  2 files changed, 39 insertions(+), 1 deletion(-)

Safe for freeze.

Reviewed-by: Andrea Bolognani <abologna@redhat.com>

-- 
Andrea Bolognani / Red Hat / Virtualization

--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list
Re: [libvirt] [PATCH] docs: Document bhyve's vgaconf support
Posted by Roman Bogorodskiy 6 years, 9 months ago
  Andrea Bolognani wrote:

> On Thu, 2017-06-29 at 10:53 +0400, Roman Bogorodskiy wrote:
> >  - 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 <bogorodskiy@gmail.com>
> > ---
> >  docs/drvbhyve.html.in | 28 +++++++++++++++++++++++++++-
> >  docs/news.xml         | 12 ++++++++++++
> >  2 files changed, 39 insertions(+), 1 deletion(-)
> 
> Safe for freeze.
> 
> Reviewed-by: Andrea Bolognani <abologna@redhat.com>

Pushed, thanks!

> -- 
> Andrea Bolognani / Red Hat / Virtualization

Roman Bogorodskiy
--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list