[dpdk-stable] patch 'doc: fix runtime options in DLB2 guide' has been queued to stable release 20.11.2

[Xueming Li]

Hi,

FYI, your patch has been queued to stable release 20.11.2

Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet.
It will be pushed if I get no objections before 06/14/21. So please
shout if anyone has objections.

Also note that after the patch there's a diff of the upstream commit vs the
patch applied to the branch. This will indicate if there was any rebasing
needed to apply to the stable branch. If there were code changes for rebasing
(ie: not only metadata diffs), please double check that the rebase was
correctly done.

Queued patches are on a temporary branch at:
https://github.com/steevenlee/dpdk

This queued commit can be viewed at:
https://github.com/steevenlee/dpdk/commit/bd41e2bc99d68b7f5eb777d9a33d90c74ff50c9e

Thanks.

Xueming Li <xuemingl at nvidia.com>

---
>From bd41e2bc99d68b7f5eb777d9a33d90c74ff50c9e Mon Sep 17 00:00:00 2001
From: Timothy McDaniel <timothy.mcdaniel at intel.com>
Date: Fri, 21 May 2021 11:11:35 +0200
Subject: [PATCH] doc: fix runtime options in DLB2 guide
Cc: Luca Boccassi <bluca at debian.org>

[ upstream commit 9e35ae0700d5a16fa949fe64c6853043a76a675e ]

Convert to PCI "--allow" devarg format.
The documentation was previously using the "--vdev" form, which cannot
be used with the DLB2 PF PMD.

Fixes: f3cad285bb88 ("event/dlb2: add infos get and configure")
Fixes: f7cc194b0f7e ("event/dlb2: add enqueue and its burst variants")
Fixes: a2e4f1f5e79f ("event/dlb2: add dequeue and its burst variants")
Fixes: 95aa7101cd3c ("doc: add some features to DLB2 guide")

Signed-off-by: Timothy McDaniel <timothy.mcdaniel at intel.com>
Signed-off-by: David Marchand <david.marchand at redhat.com>
---
 doc/guides/eventdevs/dlb2.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/doc/guides/eventdevs/dlb2.rst b/doc/guides/eventdevs/dlb2.rst
index 6ba67f278c..1223219cf7 100644
--- a/doc/guides/eventdevs/dlb2.rst
+++ b/doc/guides/eventdevs/dlb2.rst
@@ -179,19 +179,19 @@ pools' sizes are controlled by the nb_events_limit field in struct
 rte_event_dev_config. The load-balanced pool is sized to contain
 nb_events_limit credits, and the directed pool is sized to contain
 nb_events_limit/4 credits. The directed pool size can be overridden with the
-num_dir_credits vdev argument, like so:
+num_dir_credits devargs argument, like so:
 
     .. code-block:: console
 
-       --vdev=dlb1_event,num_dir_credits=<value>
+       --allow ea:00.0,num_dir_credits=<value>
 
 This can be used if the default allocation is too low or too high for the
-specific application needs. The PMD also supports a vdev arg that limits the
+specific application needs. The PMD also supports a devarg that limits the
 max_num_events reported by rte_event_dev_info_get():
 
     .. code-block:: console
 
-       --vdev=dlb1_event,max_num_events=<value>
+       --allow ea:00.0,max_num_events=<value>
 
 By default, max_num_events is reported as the total available load-balanced
 credits. If multiple DLB2-based applications are being used, it may be desirable
@@ -336,11 +336,11 @@ buffer space (e.g. if not all queues are used, or aren't used for atomic
 scheduling).
 
 The PMD provides a dev arg to override the default per-queue allocation. To
-increase a vdev's per-queue atomic-inflight allocation to (for example) 64:
+increase per-queue atomic-inflight allocation to (for example) 64:
 
     .. code-block:: console
 
-       --vdev=dlb1_event,atm_inflights=64
+       --allow ea:00.0,atm_inflights=64
 
 QID Depth Threshold
 ~~~~~~~~~~~~~~~~~~~
@@ -363,9 +363,9 @@ shown below.
 
     .. code-block:: console
 
-       --vdev=dlb2_event,qid_depth_thresh=all:<threshold_value>
-       --vdev=dlb2_event,qid_depth_thresh=qidA-qidB:<threshold_value>
-       --vdev=dlb2_event,qid_depth_thresh=qid:<threshold_value>
+       --allow ea:00.0,qid_depth_thresh=all:<threshold_value>
+       --allow ea:00.0,qid_depth_thresh=qidA-qidB:<threshold_value>
+       --allow ea:00.0,qid_depth_thresh=qid:<threshold_value>
 
 Class of service
 ~~~~~~~~~~~~~~~~
@@ -387,4 +387,4 @@ Class of service can be specified in the devargs, as follows
 
     .. code-block:: console
 
-       --vdev=dlb2_event,cos=<0..4>
+       --allow ea:00.0,cos=<0..4>
-- 
2.25.1

---
  Diff of the applied patch vs upstream commit (please double-check if non-empty:
---
--- -	2021-06-12 06:54:01.062347600 +0800
+++ 0179-doc-fix-runtime-options-in-DLB2-guide.patch	2021-06-12 06:53:56.710000000 +0800
@@ -1 +1 @@
-From 9e35ae0700d5a16fa949fe64c6853043a76a675e Mon Sep 17 00:00:00 2001
+From bd41e2bc99d68b7f5eb777d9a33d90c74ff50c9e Mon Sep 17 00:00:00 2001
@@ -4,0 +5,3 @@
+Cc: Luca Boccassi <bluca at debian.org>
+
+[ upstream commit 9e35ae0700d5a16fa949fe64c6853043a76a675e ]
@@ -14 +16,0 @@
-Cc: stable at dpdk.org
@@ -23 +25 @@
-index c60c454d6b..99ea8418a5 100644
+index 6ba67f278c..1223219cf7 100644
@@ -26 +28 @@
-@@ -152,19 +152,19 @@ These pools' sizes are controlled by the nb_events_limit field in struct
+@@ -179,19 +179,19 @@ pools' sizes are controlled by the nb_events_limit field in struct
@@ -35 +37 @@
--       --vdev=dlb2_event,num_dir_credits=<value>
+-       --vdev=dlb1_event,num_dir_credits=<value>
@@ -45 +47 @@
--       --vdev=dlb2_event,max_num_events=<value>
+-       --vdev=dlb1_event,max_num_events=<value>
@@ -49,2 +51,2 @@
- credits. If multiple DLB-based applications are being used, it may be desirable
-@@ -315,11 +315,11 @@ buffer space (e.g. if not all queues are used, or aren't used for atomic
+ credits. If multiple DLB2-based applications are being used, it may be desirable
+@@ -336,11 +336,11 @@ buffer space (e.g. if not all queues are used, or aren't used for atomic
@@ -59 +61 @@
--       --vdev=dlb2_event,atm_inflights=64
+-       --vdev=dlb1_event,atm_inflights=64
@@ -64 +66 @@
-@@ -342,9 +342,9 @@ shown below.
+@@ -363,9 +363,9 @@ shown below.
@@ -77 +79 @@
-@@ -366,4 +366,4 @@ Class of service can be specified in the devargs, as follows
+@@ -387,4 +387,4 @@ Class of service can be specified in the devargs, as follows