[RFC PATCH 10/10] docs: Added descriptions for "rss" and "rss_hash_report" configurations.

Andrew Melnychenko andrew at daynix.com
Wed Jul 28 08:17:14 UTC 2021


Signed-off-by: Andrew Melnychenko <andrew at daynix.com>
---
 docs/formatdomain.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst
index 61ccd8895a..22ad19439f 100644
--- a/docs/formatdomain.rst
+++ b/docs/formatdomain.rst
@@ -5233,6 +5233,22 @@ following attributes are available for the ``"virtio"`` NIC driver:
    only for ``vhostuser`` type. :since:`Since 3.7.0 (QEMU and KVM only)`
    **In general you should leave this option alone, unless you are very certain
    you know what you are doing.**
+``rss``
+   The ``rss`` option enables in-qemu/ebpf RSS for virtio NIC. RSS works with
+   virtio and tap backends only. For ebpf RSS the "ebpf helper" is used. Helper
+   binary path received from qemu by qmp. The helper is't used if qemu doesn't
+   provide "ebpf_rss_fds" property or helper path. Without helper, virtio NIC
+   will be launched only with "rss" property. Qemu may load eBPF by itself if it
+   has CAP_SYS_ADMIN permissions. In other cases, "in-qemu" RSS is used.
+   **In general you should leave this option alone, unless you are very certain
+   you know what you are doing.**
+``rss_hash_report``
+   The ``rss_hash_report`` option enables in-qemu RSS hash report for virtio
+   NIC. Ebpf RSS doesn't support hash report yet. Usually enabled alongside with
+   ``rss``. Without ``rss`` option, the hash report doesn't affect steering
+   itself but provides vnet header with a calculated hash.
+   **In general you should leave this option alone, unless you are very certain
+   you know what you are doing.**
 virtio options
    For virtio interfaces, `Virtio-specific options <#elementsVirtio>`__ can also
    be set. ( :since:`Since 3.5.0` )
-- 
2.31.1




More information about the libvir-list mailing list