docs: documentation for virtio packed option

Reviewed-by: Boris Fiuczynski <fiuczy@linux.ibm.com>
Signed-off-by: Bjoern Walk <bwalk@linux.ibm.com>
Reviewed-by: Ján Tomko <jtomko@redhat.com>
Signed-off-by: Ján Tomko <jtomko@redhat.com>

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index d56600dc18cda9d160d4bb4b651aefc52f54b9d4..47e10a836c47f128e5c2988164ff09df97ba1c53 100644 (file)
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -4372,6 +4372,16 @@
       Possible values are <code>on</code> or <code>off</code>.
       <span class="since">Since 3.5.0</span>
     </p>
+    <p>
+      The attribute <code>packed</code> controls if QEMU should try to use
+      packed virtqueues. Compared to regular split queues, packed queues
+      consist of only a single descriptor ring replacing available and used
+      ring, index and descriptor buffer. This can result in better cache
+      utilization and performance. If packed virtqueues are actually used
+      depends on the feature negotiation between QEMU, vhost backends and guest
+      drivers. Possible values are <code>on</code> or <code>off</code>.
+      <span class="since">Since 6.3.0 (QEMU and KVM only)</span>
+    </p>
 
     <h4><a id="elementsVirtioTransitional">Virtio transitional devices</a></h4>