[PATCH] docs: bhyve: document virtio-console and blkiotune

Roman Bogorodskiy posted 1 patch 1 week, 5 days ago
Patches applied successfully (tree, apply log)
git fetch https://github.com/patchew-project/libvirt tags/patchew/20260502123255.13508-1-bogorodskiy@gmail.com
docs/drvbhyve.rst | 38 ++++++++++++++++++++++++++++++++++++++
1 file changed, 38 insertions(+)
[PATCH] docs: bhyve: document virtio-console and blkiotune
Posted by Roman Bogorodskiy 1 week, 5 days ago
Add sections describing usage of the virtio-console device
and about block I/O tuning.

Signed-off-by: Roman Bogorodskiy <bogorodskiy@gmail.com>
---
 docs/drvbhyve.rst | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/docs/drvbhyve.rst b/docs/drvbhyve.rst
index e9eceb8740..79418537df 100644
--- a/docs/drvbhyve.rst
+++ b/docs/drvbhyve.rst
@@ -819,6 +819,44 @@ Example:
 Every NUMA domain must have `memory` and `cpus` specified.
 Bhyve allows configuring up to 8 NUMA domains.
 
+Virtio-console device
+~~~~~~~~~~~~~~~~~~~~~
+
+:since:`Since 12.4.0`, it is possible to use the virtio console device.
+Example::
+
+  <devices>
+    <channel type='unix'>
+      <source mode='bind' path='/var/run/libvirt/bhyve/bhyve.agent'/>
+      <target type='virtio' name='org.qemu.guest_agent.0'/>
+      <address type='virtio-serial' controller='0' bus='0' port='1'/>
+    </channel>
+  </devices>
+
+Bhyve supports up to 16 ports per console.
+
+Block I/O Tuning
+~~~~~~~~~~~~~~~~
+:since:`Since 12.3.0`, it is possible to tune domain I/O.
+This works on top of the
+`rctl(4) <https://man.freebsd.org/cgi/man.cgi?query=rctl&sektion=4>`__
+framework.
+Sample configuration::
+
+  <blkiotune>
+    <device>
+      <path>*</path>
+      <read_iops_sec>20000</read_iops_sec>
+      <write_iops_sec>20000</write_iops_sec>
+      <read_bytes_sec>10000</read_bytes_sec>
+      <write_bytes_sec>10000</write_bytes_sec>
+    </device>
+  </blkiotune>
+
+The ``*`` path here means that the limits are applied to the domain
+as a whole. Currently, it is not possible to apply limits to the
+individual devices of the domain.
+
 Guest-specific considerations
 -----------------------------
 
-- 
2.52.0
Re: [PATCH] docs: bhyve: document virtio-console and blkiotune
Posted by Peter Krempa via Devel 1 week, 4 days ago
On Sat, May 02, 2026 at 14:32:55 +0200, Roman Bogorodskiy wrote:
> Add sections describing usage of the virtio-console device
> and about block I/O tuning.
> 
> Signed-off-by: Roman Bogorodskiy <bogorodskiy@gmail.com>
> ---
>  docs/drvbhyve.rst | 38 ++++++++++++++++++++++++++++++++++++++
>  1 file changed, 38 insertions(+)

Reviewed-by: Peter Krempa <pkrempa@redhat.com>