Skip to contentSkip to conversation

doc: update virtio prog guide with new feature list

PATCH Applied Kommula Shiva Shankar 2 participants 3 messages Mar 4, 2025 – Mar 12, 2025

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: update virtio prog guide with new feature list

This patch adds newly added virtio hash report feature to prog guide.

---
 doc/guides/nics/virtio.rst | 3 +++
 1 file changed, 3 insertions(+)
doc/guides/nics/virtio.rst +3 -0
index c22ce56a02..0615abfaaf 100644
@@ -56,6 +56,7 @@ In this release, the virtio PMD provides the basic functionality of packet recep
     command line. Note that, mac/vlan filter is best effort: unwanted packets could still arrive.
 
 *   "RTE_PKTMBUF_HEADROOM" should be defined
+    no less than "sizeof(struct virtio_net_hdr_hash_report)", which is 20 bytes when using hash report or
     no less than "sizeof(struct virtio_net_hdr_mrg_rxbuf)", which is 12 bytes when mergeable or
     "VIRTIO_F_VERSION_1" is set.
     no less than "sizeof(struct virtio_net_hdr)", which is 10 bytes, when using non-mergeable.
@@ -68,6 +69,8 @@ In this release, the virtio PMD provides the basic functionality of packet recep
 
 *   Virtio supports software vlan stripping and inserting.
 
+*   Virtio supports hash report feature in packed queue mode.
+
 *   Virtio supports using port IO to get PCI resource when UIO module is not available.
 
 *   Virtio supports RSS Rx mode with 40B configurable hash key length, 128
Signature · 1 line
2.43.0
Reviewed-by on v1 1/1
#1 lore raw
Quoted 21 lines · Kommula Shiva Shankar

This patch adds newly added virtio hash report feature to prog guide.

---
  doc/guides/nics/virtio.rst | 3 +++
  1 file changed, 3 insertions(+)
doc/guides/nics/virtio.rst +1 -0
index c22ce56a02..0615abfaaf 100644
@@ -56,6 +56,7 @@ In this release, the virtio PMD provides the basic functionality of packet recep
      command line. Note that, mac/vlan filter is best effort: unwanted packets could still arrive.
 
  *   "RTE_PKTMBUF_HEADROOM" should be defined
+    no less than "sizeof(struct virtio_net_hdr_hash_report)", which is 20 bytes when using hash report or
      no less than "sizeof(struct virtio_net_hdr_mrg_rxbuf)", which is 12 bytes when mergeable or
      "VIRTIO_F_VERSION_1" is set.
      no less than "sizeof(struct virtio_net_hdr)", which is 10 bytes, when using non-mergeable.

doc/guides/nics/virtio.rst In this release, the virtio PMD provides the basic functionality of packet recep · line 76

Quoted 8 lines
doc/guides/nics/virtio.rst +2 -0
@@ -68,6 +69,8 @@ In this release, the virtio PMD provides the basic functionality of packet recep
 
  *   Virtio supports software vlan stripping and inserting.
 
+*   Virtio supports hash report feature in packed queue mode.
+
  *   Virtio supports using port IO to get PCI resource when UIO module is not available.
 
  *   Virtio supports RSS Rx mode with 40B configurable hash key length, 128

Thanks,
Maxime

#2 lore raw
In reply to Kommula Shiva Shankar
Quoted 21 lines · Kommula Shiva Shankar

This patch adds newly added virtio hash report feature to prog guide.

---
  doc/guides/nics/virtio.rst | 3 +++
  1 file changed, 3 insertions(+)
doc/guides/nics/virtio.rst +1 -0
index c22ce56a02..0615abfaaf 100644
@@ -56,6 +56,7 @@ In this release, the virtio PMD provides the basic functionality of packet recep
      command line. Note that, mac/vlan filter is best effort: unwanted packets could still arrive.
 
  *   "RTE_PKTMBUF_HEADROOM" should be defined
+    no less than "sizeof(struct virtio_net_hdr_hash_report)", which is 20 bytes when using hash report or
      no less than "sizeof(struct virtio_net_hdr_mrg_rxbuf)", which is 12 bytes when mergeable or
      "VIRTIO_F_VERSION_1" is set.
      no less than "sizeof(struct virtio_net_hdr)", which is 10 bytes, when using non-mergeable.

doc/guides/nics/virtio.rst In this release, the virtio PMD provides the basic functionality of packet recep · line 76

Quoted 8 lines
doc/guides/nics/virtio.rst +2 -0
@@ -68,6 +69,8 @@ In this release, the virtio PMD provides the basic functionality of packet recep
 
  *   Virtio supports software vlan stripping and inserting.
 
+*   Virtio supports hash report feature in packed queue mode.
+
  *   Virtio supports using port IO to get PCI resource when UIO module is not available.
 
  *   Virtio supports RSS Rx mode with 40B configurable hash key length, 128

Applied to next-virtio.

Thanks,
Maxime