From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id DB32CA0471 for ; Mon, 12 Aug 2019 09:13:21 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id D42E22629; Mon, 12 Aug 2019 09:13:21 +0200 (CEST) Received: from mail-pf1-f174.google.com (mail-pf1-f174.google.com [209.85.210.174]) by dpdk.org (Postfix) with ESMTP id 6839E2629 for ; Mon, 12 Aug 2019 09:13:20 +0200 (CEST) Received: by mail-pf1-f174.google.com with SMTP id g2so49259637pfq.0 for ; Mon, 12 Aug 2019 00:13:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:date:message-id:in-reply-to:references; bh=5b+9yn+gY0vGSvP2I28YT1WadgLXSlBKKTimN+qxuRI=; b=kLgZZWxuUbDPzmQlELCeS8Xu9r7kJ3KHxy46w9C7I99q7hDIjKdx2ifDg6RIRSHzIY +CjGB+CZ+xFoJQL9+YmbW1xW0MogGODz2J6J6uPVXXz/ixTC5baqa5aAuxSr2IogJ2BJ 4W0hNQ77zFXHs7eYtem7o3raOFPB2fJe2r1yhO1GeSk/BztN+ZBENHla/NOQx1mfMEkk U7T33P5ckVmTlpBJMMvYYTlDMcNAYLHZRr74xJKRDx60+E4zXqnoaiF2pOak4TYrVVwc 5B/pZpo/LJ9D7gaoEXH/zkdt1rz/Otp9qV3Vf7lGOE+ZpMVHN8E6HwIwkPGXVfXqBYKB rhhg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references; bh=5b+9yn+gY0vGSvP2I28YT1WadgLXSlBKKTimN+qxuRI=; b=Ual97SfXJeZCV0RvUWS04pPcTAOBeVpi6EDRDXrDv6zZT2tQ+1Hj6Bx0MepLphrY5z I5TSjtU+G4o1nvu7A98PaRjnRLreWaGeWTGcEwY0/SUIts05dSO3e1oFm8k415H7twHZ B/EQiztkGHuzaz6VJvYo7l/49ItSEhO3HKVZ98Iex6r9BrjUUz9xirQO0RPjdyl4eDU4 VUVBETLCMuOE1Ww1e/MmR8Cv2EgV7xyL3WY82BPKBdJzlNzHO+9AbEnFpI39jQcBiEI4 Vdpt7Ij8vuE4P0vk37XpWLEtVYb52I6R88qemFJTr47O5gJHNcCZqIKiXfZuFzEPkSjV r45A== X-Gm-Message-State: APjAAAWlstpONCDuwgSIoNsESUlK1QKoao5QRDhdKc2Ux3ZkVsQfUtYu n4klM5piQztdkTWBry68p/mC5emP X-Google-Smtp-Source: APXvYqyMnuIcxVEDU7WGibFpwkdNDQzHFWgnr4cwXOpVSJODIqRv3rzIffWDZs4F8WTLhMKiAdiKXg== X-Received: by 2002:a63:1d4:: with SMTP id 203mr28788523pgb.441.1565593999513; Mon, 12 Aug 2019 00:13:19 -0700 (PDT) Received: from localhost.localdomain ([2400:4050:c8c2:de00:8000:cb51:dfcb:76c]) by smtp.gmail.com with ESMTPSA id v22sm102073794pgk.69.2019.08.12.00.13.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 12 Aug 2019 00:13:19 -0700 (PDT) From: Yasufumi Ogawa To: spp@dpdk.org, ferruh.yigit@intel.com, yasufum.o@gmail.com Date: Mon, 12 Aug 2019 16:13:09 +0900 Message-Id: <20190812071309.18991-4-yasufum.o@gmail.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20190812071309.18991-1-yasufum.o@gmail.com> References: <20190812071309.18991-1-yasufum.o@gmail.com> Subject: [spp] [PATCH 3/3] docs: add usage of blacklist for SPP container X-BeenThere: spp@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: Soft Patch Panel List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: spp-bounces@dpdk.org Sender: "spp" 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 --- docs/guides/tools/sppc/getting_started.rst | 45 +++++++++++++++++++++- 1 file changed, 44 insertions(+), 1 deletion(-) 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: -- 2.17.1