[dpdk-dev,PKTGEN,2/2] usage_pktgen.rst: multiple instances: clarify EAL options needed

Message ID 1453355440-29364-2-git-send-email-mhall@mhcomputing.net (mailing list archive)
State Not Applicable, archived
Headers

Commit Message

Matthew Hall Jan. 21, 2016, 5:50 a.m. UTC
  Signed-off-by: Matthew Hall <mhall@mhcomputing.net>
---
 docs/source/usage_pktgen.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
  

Comments

Wiles, Keith Jan. 21, 2016, 3:40 p.m. UTC | #1
On 1/20/16, 11:50 PM, "dev on behalf of Matthew Hall" <dev-bounces@dpdk.org on behalf of mhall@mhcomputing.net> wrote:

>Signed-off-by: Matthew Hall <mhall@mhcomputing.net>

>---

> docs/source/usage_pktgen.rst | 15 +++++++++++++++

> 1 file changed, 15 insertions(+)

>

>diff --git a/docs/source/usage_pktgen.rst b/docs/source/usage_pktgen.rst

>index efe8aa4..223d033 100644

>--- a/docs/source/usage_pktgen.rst

>+++ b/docs/source/usage_pktgen.rst

>@@ -157,4 +157,19 @@ The -m option then assigns lcores to the ports.

> The information from above is taken from two new files pktgen-master.sh

> and pktgen-slave.sh, have a look at them and adjust as you need.

> 

>+The following DPDK / EAL options must be configured correctly as well:

>+

>+* ``-l lcore_id_list``: non-conflicting list of lcores for each app


If you are going to add -l option then you need to add the -c option too.
>+

>+* ``--master-lcore lcore_id``: non-conflicting master lcore for each app


This option is not required for pktgen or DPDK, which I think we can leave out.
>+

>+* ``-m hugepage_mb / --socket-mem hugepage_mb_list``: non-conflicting amount

>+of hugepage memory for each app, or for each app on each CPU socket

>+

>+* ``--no-shconf``: prevents DPDK from claiming a lockfile that breaks

>+concurrent use of multiple apps


This one is not required, correct? As long as you set the primary processes file-prefix to different prefixes for each one.
>+

>+* ``--file-prefix``: assigns a unique name to the hugepage mmap() files for

>+each app

>+

> Pktgen can also be configured using the :ref:`commands`.

>-- 

>2.5.0

>

>



Regards,
Keith
  

Patch

diff --git a/docs/source/usage_pktgen.rst b/docs/source/usage_pktgen.rst
index efe8aa4..223d033 100644
--- a/docs/source/usage_pktgen.rst
+++ b/docs/source/usage_pktgen.rst
@@ -157,4 +157,19 @@  The -m option then assigns lcores to the ports.
 The information from above is taken from two new files pktgen-master.sh
 and pktgen-slave.sh, have a look at them and adjust as you need.
 
+The following DPDK / EAL options must be configured correctly as well:
+
+* ``-l lcore_id_list``: non-conflicting list of lcores for each app
+
+* ``--master-lcore lcore_id``: non-conflicting master lcore for each app
+
+* ``-m hugepage_mb / --socket-mem hugepage_mb_list``: non-conflicting amount
+of hugepage memory for each app, or for each app on each CPU socket
+
+* ``--no-shconf``: prevents DPDK from claiming a lockfile that breaks
+concurrent use of multiple apps
+
+* ``--file-prefix``: assigns a unique name to the hugepage mmap() files for
+each app
+
 Pktgen can also be configured using the :ref:`commands`.