diff options
author | Yasufumi Ogawa <yasufum.o@gmail.com> | 2019-08-12 16:13:09 +0900 |
---|---|---|
committer | Yasufumi Ogawa <yasufum.o@gmail.com> | 2019-08-13 17:08:18 +0900 |
commit | 748ccd7b6f81b928d733303d81d1887af50c6360 (patch) | |
tree | 0f7029e51a379d3a795e7b62ca214fe6071736d8 | |
parent | 3dbb7ad5f409f544c373149cec87067f228d2cdb (diff) | |
download | spp-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.rst | 45 |
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: |