From cd6c5bc8f4b525c881418559370854d4920dbca3 Mon Sep 17 00:00:00 2001
From: Kevin Traynor
Date: Mon, 24 Apr 2017 18:48:34 +0100
Subject: [PATCH] docs: Add some detail about dpdk-socket-mem.
Using dpdk-socket-mem to allocate memory for some NUMA nodes
but leaving blank for subsequent ones is equivalent of assigning
0 MB memory to those subsequent nodes. Document this behavior.
Signed-off-by: Kevin Traynor
Signed-off-by: Ben Pfaff
---
Documentation/intro/install/dpdk.rst | 7 ++++++-
vswitchd/vswitch.xml | 5 +++--
2 files changed, 9 insertions(+), 3 deletions(-)
diff --git a/Documentation/intro/install/dpdk.rst b/Documentation/intro/install/dpdk.rst
index f29ac05ddeb..d1c0e651e70 100644
--- a/Documentation/intro/install/dpdk.rst
+++ b/Documentation/intro/install/dpdk.rst
@@ -226,11 +226,16 @@ listed below. Defaults will be provided for all values not explicitly set.
If allocating more than one GB hugepage, you can configure the
amount of memory used from any given NUMA nodes. For example, to use 1GB from
-NUMA node 0, run::
+NUMA node 0 and 0GB for all other NUMA nodes, run::
$ ovs-vsctl --no-wait set Open_vSwitch . \
other_config:dpdk-socket-mem="1024,0"
+or::
+
+ $ ovs-vsctl --no-wait set Open_vSwitch . \
+ other_config:dpdk-socket-mem="1024"
+
Similarly, if you wish to better scale the workloads across cores, then
multiple pmd threads can be created and pinned to CPU cores by explicity
specifying ``pmd-cpu-mask``. Cores are numbered from 0, so to spawn two pmd
diff --git a/vswitchd/vswitch.xml b/vswitchd/vswitch.xml
index 870c8131831..02980b12691 100644
--- a/vswitchd/vswitch.xml
+++ b/vswitchd/vswitch.xml
@@ -259,8 +259,9 @@
The specifier is a comma-separated string, in ascending order of CPU
- socket (ex: 1024,2048,4096,8192 would set socket 0 to preallocate
- 1024MB, socket 1 to preallocate 2048MB, etc.)
+ socket. E.g. On a four socket system 1024,0,2048 would set socket 0
+ to preallocate 1024MB, socket 1 to preallocate 0MB, socket 2 to
+ preallocate 2048MB and socket 3 (no value given) to preallocate 0MB.
If dpdk-socket-mem and dpdk-alloc-mem are not specified, dpdk-socket-mem