diff mbox

[ovs-dev,8/8] Documentation: Update DPDK doc with vhost-enqueue-retry option.

Message ID 1496827265-19785-9-git-send-email-bhanuprakash.bodireddy@intel.com
State Superseded
Headers show

Commit Message

Bodireddy, Bhanuprakash June 7, 2017, 9:21 a.m. UTC 
Retries on vHost User port are disabled by default and can be enabled
by setting 'vhost-enqueue-retry' to a value less than or equal to 8.

Signed-off-by: Bhanuprakash Bodireddy <bhanuprakash.bodireddy@intel.com>
Signed-off-by: Antonio Fischetti <antonio.fischetti@intel.com>
Co-authored-by: Antonio Fischetti <antonio.fischetti@intel.com>
---
 Documentation/howto/dpdk.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
diff mbox

Patch

diff --git a/Documentation/howto/dpdk.rst b/Documentation/howto/dpdk.rst
index f3c7aff..0324d10 100644
--- a/Documentation/howto/dpdk.rst
+++ b/Documentation/howto/dpdk.rst
@@ -407,6 +407,23 @@  For certain traffic profiles with many parallel flows, it's recommended to set
 
 For more information on the EMC refer to :doc:`/intro/install/dpdk` .
 
+.. _dpdk-vhost-retries:
+
+vHost User port Retries
+-----------------------
+
+By default no retries are performed when few of the packets aren't successfully
+transmitted on previous attempt. Retries are disabled to lessen throughput impact
+in cases where multiple vHost User ports are serviced by the same PMD thread.
+
+In cases where a particular OvS-DPDK deployment expects no/minimal packet loss,
+retries can be enabled to re-enqueue the unsuccessful packets in previous attempt.
+A maximum of 8 retries are allowed.
+
+For example to perform 3 retries::
+
+    $ ovs-vsctl --no-wait set Open_vSwitch . other_config:vhost-enque-retry=3
+
 .. _dpdk-ovs-in-guest:
 
 OVS with DPDK Inside VMs