summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorYasufumi Ogawa <yasufum.o@gmail.com>2019-08-12 16:13:09 +0900
committerYasufumi Ogawa <yasufum.o@gmail.com>2019-08-13 17:08:18 +0900
commit748ccd7b6f81b928d733303d81d1887af50c6360 (patch)
tree0f7029e51a379d3a795e7b62ca214fe6071736d8
parent3dbb7ad5f409f544c373149cec87067f228d2cdb (diff)
downloadspp-748ccd7b6f81b928d733303d81d1887af50c6360.zip
spp-748ccd7b6f81b928d733303d81d1887af50c6360.tar.gz
spp-748ccd7b6f81b928d733303d81d1887af50c6360.tar.xz
docs: add usage of blacklist for SPP container
This update is to add description of usage of blacklist option. It describes how to inspect PCI addresses and how to specify them while launching app container. Signed-off-by: Yasufumi Ogawa <yasufum.o@gmail.com>
-rw-r--r--docs/guides/tools/sppc/getting_started.rst45
1 files changed, 44 insertions, 1 deletions
diff --git a/docs/guides/tools/sppc/getting_started.rst b/docs/guides/tools/sppc/getting_started.rst
index d92b55f..4834cc0 100644
--- a/docs/guides/tools/sppc/getting_started.rst
+++ b/docs/guides/tools/sppc/getting_started.rst
@@ -256,9 +256,52 @@ app container launcher.
Done
testpmd>
-
It launches ``testpmd`` in foreground mode.
+.. note::
+
+ DPDK app container tries to own ports on host which are shared with host
+ and containers by default. It causes a confliction between SPP running on
+ host and containers and unexpected behavior.
+
+ To avoid this situation, it is required to use ``-b`` or
+ ``--pci-blacklist`` EAL option to exclude ports on host. PCI address of
+ port can be inspected by using ``dpdk-devbind.py -s``.
+
+If you have ports on host and assign them to SPP, you should to exclude them
+from the app container by specifying PCI addresses of the ports with ``-b``
+or ``--pci-blacklist``.
+
+You can find PCI addresses from ``dpdk-devbind.py -s``.
+
+.. code-block:: console
+
+ # Check the status of the available devices.
+ dpdk-devbind --status
+ Network devices using DPDK-compatible driver
+ ============================================
+ 0000:0a:00.0 '82599ES 10-Gigabit' drv=igb_uio unused=ixgbe
+ 0000:0a:00.1 '82599ES 10-Gigabit' drv=igb_uio unused=ixgbe
+
+ Network devices using kernel driver
+ ===================================
+ ...
+
+In this case, you should exclude ``0000:0a:00.0`` and ``0000:0a:00.1``
+with ``-b`` option.
+
+.. code-block:: console
+
+ # Terminal 3
+ $ cd /path/to/spp/tools/sppc
+ $ app/testpmd.py -l 3-4 -d 1,2 \
+ -b 0000:0a:00.0 0000:0a:00.1
+ sudo docker run -it \
+ ...
+ -b 0000:0a:00.0 \
+ -b 0000:0a:00.1 \
+ ...
+
.. _sppc_gs_run_apps: