From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM01-BY2-obe.outbound.protection.outlook.com (mail-by2nam01on0041.outbound.protection.outlook.com [104.47.34.41]) by dpdk.org (Postfix) with ESMTP id DB46DD040 for ; Thu, 6 Apr 2017 09:54:08 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=CAVIUMNETWORKS.onmicrosoft.com; s=selector1-cavium-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=luNN0Si96OPbEByrBttekfj4UJ5ogiu7IMR5gnCmSkA=; b=i1qclXj0dpfsn57H/uXQjIvDMxpBufpX/WQR+9O5UHPZvq/zDo/HcNdCBEFnOFQr8r9FCZbCxnCOXp5cto0hTkuVy1usQP4EzfSj04T5FxTibOpUf5GgSbYxAZiqlrTCDHtTZE7xeCNDwx9VRrJWGI50iUTJSjxgH1Y3I6T15n4= Authentication-Results: intel.com; dkim=none (message not signed) header.d=none;intel.com; dmarc=none action=none header.from=caviumnetworks.com; Received: from lio357.in.caveonetworks.com (14.140.2.178) by DM3PR07MB2284.namprd07.prod.outlook.com (10.164.33.158) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1005.10; Thu, 6 Apr 2017 07:54:05 +0000 From: Shijith Thotton To: John Mcnamara , Ferruh Yigit Cc: dev@dpdk.org Date: Thu, 6 Apr 2017 13:21:51 +0530 Message-Id: <1491465117-11252-3-git-send-email-shijith.thotton@caviumnetworks.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1491465117-11252-1-git-send-email-shijith.thotton@caviumnetworks.com> References: <1491059040-20647-1-git-send-email-shijith.thotton@caviumnetworks.com> <1491465117-11252-1-git-send-email-shijith.thotton@caviumnetworks.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Originating-IP: [14.140.2.178] X-ClientProxiedBy: BM1PR01CA0027.INDPRD01.PROD.OUTLOOK.COM (10.163.198.162) To DM3PR07MB2284.namprd07.prod.outlook.com (10.164.33.158) X-MS-Office365-Filtering-Correlation-Id: cec43bad-d874-4036-da5e-08d47cc219ec X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 3:jKlPltmff0GHDrQRoYKEIs9qZddkG9xM8a3JSMpFmAaIG0xErPrkMLQw47BWb9slLejxbi3+3xsAyAcY/hxpyd7+IwALaa0v2hK4721JYTaaLnXmp0Eern7UuBlnwFJLBp9UEHUwvytF4c9YCdfPGTiR/OcLO+TFISmsFW8Z8S2hJYCBv8ZDm+bR1Z/y3969J3Sq1xK9Ojvnc68l9ssttGDOsqeW1hhX6Xkru5xgSNNYXo+Nb6NsqfC9xCubim72E8wtqBdbbYBQliaKGUhx4izReN9DlMctSGgydn8TfNHbpDAVi7z8bOa11dO/mqlFISu4/zxPRx3GG5hxJoIx2A==; 25:ieq90jYUD1oK9WHzw5mlbFNQjGI6tjTLosNsKDTsTowpbspwpsxD78Ro+OnYFV2xSudHSraVWt6+bOOUzZFBvOmL6fGhoJ0goPnRVn0Iva3dTk7IxFAiEgnWN6UQ+YTe4UCbuw+tLzCyzRWUfue37p/xuTue4+h2KBq9xFolr5oFzOZi2vSj9J9xqhN3aPfwKKQUT61o3SqWYjFNs+Byc2C2q4VfTLd8En/0A4s96+Sews2ruc1jjyi3P2uLxm0bkIwmB/3O+D7PsVxRoDMhizHTKo2eUuGm2TX7W8hpNtCPSFBrS32hHPOalbeZUbu7W0yudKNHOOJdqak60LFSmS0txLnpBaxev5+lxRxr9NRmAVbZQ5OMJAnSZ07RpQz8vgqwKFI2oK9YIhIXp8lss5wrIgWvv04bBXirpxwV7Fevfvv7438GFoN/RSSBPccPeY1fVtDGVd44tN9c39IK9A== X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 31:6v913CKXPg5J0FGpa9GWnxs/g0bGYkZ3YiGKogDv+KyRhvR2O2E3qDKdSiksEV/YRDq38FnKfszfOaXukfQyo4V5RqYg5K4p8O1IxKyFLeq0NMKnmBjIOy+6Sg30UJJ0qRoj0u5BWFHObKu7DnT7arsswaGDLpinqcU1J6mYWFM78pcczvnJjbzzT8OrJz5yuXPpnK5Y3FxS1UhlQaXMYwaBToE3zjXk9biyb3WIy5t60WxqRykvl0T+pTgeytPU; 20:gHNdYrVbLnq1TJmLVWduheYe+ZW4e/7BsZdHvIKle3C2pl2ZQuSusamcm2PwH/0R3j8x83BmPLTUV5ChTib5FL3PoU04u1XtqaPW461XiAEPL9bMqFqkLZ8oQabC+BXSiVZqcGgdqUYjaRAGgBTdH5NszR3WT4I/c3/9N3pXqubOsiYo4eN46qvFZmw1bE6wKaYor5flHleo3hltukXtrsvMNSRP0xfGzO9cEOa0r08gEaJD597EVqiq0ycQTX/vL0y0Vahsu1aymaAK7Fn2+YgK9isNjL1uNF0+6G4sWAoNfBG+qmUp7kHJmUCr+oTuxAk0TLQbz8Ga+oH9AOq43L1MYTARzwDg9UGXMDoU9os2wnijZNO07Wx1T3YPZ7BCkxBYMAv2IA4zW8fsOZG32S0iDIAVvrnOeZLUy39xTPZoc5e1of5GmnsQJpEILMU3MqEb5ketZGVXAswxPQWTZ11Pdzrzj+Iem46JXEiTl09mKeoTo1Q+IWzqDbzPJXiDd9l83LrO3X/7tpdJfwKjEMgEenLPGZYcNuaH/c9G337qJpcpAivj06RyLptXkCg4ZDfEycr7TUF8HKUYkGyz27qlpj852zsMcs9pYEfjkt0= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(601004)(2401047)(8121501046)(5005006)(93006095)(10201501046)(3002001)(6041248)(20161123564025)(20161123560025)(20161123555025)(20161123562025)(201703131423075)(201702281528075)(201703061421075)(6072148); SRVR:DM3PR07MB2284; BCL:0; PCL:0; RULEID:; SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 4:TYHKVuSAMVIrgPUP7igMZsdaZW5gN6tFvLXy5Gpvqrj2qyWkDD537bxmTtthJMmHl39T1cCAhI2KCeY5BM6tcKuTcTdDbJzSfkGJpdi7AzLDYylY7fN2GKpaC61BUS0PJwDFUlNRGDfulJu75eOhIh2iFRQfsl/B3GMmq9p7HnesmS20NUWg6TU+WL13Zkk665VLrnSOgjGJ24fUEc41NXCZ8sGWsFEB3+B9oWGlm2Eg2xbDaRdCiczSzIiwKriPUyaHAqhOgPNvQ9wPPnTB3jUuGUlkCEwt/VuvLsAx25VMrHNORsUNG7m0Lsnt2PdCOszCapaK0gu0u9TtGt3T1pEd0DGPy4cUiLT7CsytVIPHUrScdiEGvIgudVlqmPQptMVsaD1rQ3+cX3Lr2LLSRemi32FuuPPXoCU6QODD7h8tMk/9D9yfZeTVqVnsrG8VyxFp+rl3MN+lYGCjKx9WhVTrO2EhusCZzQE4Lcn1m5r70f2F84w6rPOZOaRkS9Y8+mou7eQ8zt5bdCXEUd1aT+GBx30KRHPU3QIMtfVQok2Ie1Lq3BdXIa/+VHOa2QW1o654uayxteKgOAzSemjCqUfjQIUsBsBeEUC1Vh8i/703AtayAXojGkT1zgv1tzx4vUDHOhkWtCXJfehk3tV3ZGE8Z8u2OLsfsvAxiUDwqRD6ULKg65RynOQL1EiavQ8Y X-Forefront-PRVS: 02698DF457 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39840400002)(39450400003)(39400400002)(39850400002)(39410400002)(50986999)(76176999)(36756003)(50226002)(6506006)(6512007)(4326008)(47776003)(53936002)(6666003)(25786009)(23676002)(66066001)(50466002)(42882006)(2950100002)(4720700003)(38730400002)(6486002)(6116002)(5660300001)(3846002)(33646002)(2906002)(7736002)(305945005)(5009440100003)(8676002)(189998001)(81166006)(42186005)(2870700001)(110426004); DIR:OUT; SFP:1101; SCL:1; SRVR:DM3PR07MB2284; H:lio357.in.caveonetworks.com; FPR:; SPF:None; MLV:nov; PTR:InfoNoRecords; LANG:en; X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtETTNQUjA3TUIyMjg0OzIzOjNPcVYwYjVWUG9tY3k4RVluREdYMWZpVjJm?= =?utf-8?B?ejdOQ1E4K05aT1NoQU1hK1V0RDdzTEdKNEZPQm9vVDc3T0dPRzZLWDhmNlFB?= =?utf-8?B?Sk1nUGdRcHQ4NHZXdGJOakRPUG4rS3JDNmNhdTVETlJoYnNsRkNWeWViQ2Fh?= =?utf-8?B?bktxM0h3ZzdsdGtFcDFINWZrSngwWVVuRGJoaGxnRDRsWW04UHo1eXI2SHI3?= =?utf-8?B?ZnhqMTZnd2MwbWRNUSs0bmtTcG5RbkJ3NWc2MU5ON3AvanVDZ25kbmltcS8x?= =?utf-8?B?THRmTWduUVJKV1VPRnVBdVQwWmlFamNUSjg2R05lcjJHOEY3amdheVdnYXFX?= =?utf-8?B?ZzBZTjNIdlpRVVpERk5tN0w5VERMaDBhaElIc1J3aXcwbFVLa1Q0YTB0NVEz?= =?utf-8?B?aGd5eE9jRzhuLzhFMngvUnNwYlZoRVZvMElWR0lZbUQwV0lIWjdJYkl0R1hQ?= =?utf-8?B?MU51cUh2VDBTRnM3bHBNY1RVWDdDbnMwMEZiZS85U01CMnR2Zzd5c2ZndTBq?= =?utf-8?B?eDJyTVZoZko0bWJUWHMvK3E1cGgrZmJwbFZGZEpvL0d6dG1IREhVMnNCT3Jv?= =?utf-8?B?V2hib2lOWHZDeEUvc1UzQzB5T0ZSQmsxcklpYlhaR0IxNWVVdUU3NWEzMngy?= =?utf-8?B?L0RhNzI1Z1JYdUhhYWE2eU5OWXFlYzBUNzZQWnlpY0xiMktXREg5Mk53b0Jp?= =?utf-8?B?M3l5elJLWFVKSVRrMkFtczlud1FhbTY5TTl2MGJaQTJuUjN1dzJqQmVoazZB?= =?utf-8?B?RXIzTnFUemZxT2xnNnB3UHowRVM5ZzYxNXhZQXBPb1hYK2VtU294TGFBWFBR?= =?utf-8?B?Z09JYzA2WkgvY25CNmJKNTVSTVNhSExmdWZGMktpZlhNbytYYjZKREVWaWx4?= =?utf-8?B?dDJqZjZ5SzFMNHB0eG9ZV2YxSEd2Y3FhNk9xMlhGUWNYb0NXVDJUSnBGWmZV?= =?utf-8?B?WWVlSFh1cmR5RmdyYVVtRUlkeGhpZlU2cVNLN2dNSCtraVNWcG9jR3dBUURr?= =?utf-8?B?QTNHaUJrR2JyMkZTR0J4ZHNKejhicEhYUmdBQ0pKLys5SnNkQXlxaDhSWlY2?= =?utf-8?B?UHJtUWNIU2Z6V1BLZFRjRjRlWnQ1bHpwQ0F4MGhIWk40WmNLSkFRaSsrbmxy?= =?utf-8?B?M3lVcjlnSDlkQkRhVFpDeGpYTEtXUFpQSVpkdnoxSHlScVpGOVcyR3NlNWZl?= =?utf-8?B?RXgrOG1LdFFucVMvMXhqOUEvMjNHN2RGMWJhbFh1bDBlSmNHRVBpcmJEd1ZR?= =?utf-8?B?a2RSclhyVWwyYlpFR29ncURxOGIxQ1RhZWpDeDU0eXN6MTVzSElGQjViZ21u?= =?utf-8?B?ZDJIT2F3OHdLZUlUcW9QTFFtc3VVcGkzWWFIcXpTRENUdWdQamtROVloeURi?= =?utf-8?B?dlplZVVZaGs2d0w5N0VaQ2FCVE11a29DVCtjRGRnPT0=?= X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 6:/iEJ4t8HYc1JBXw+pSKT7kxSptuk4v/2Oo7qBZaTF/SZgTWL03lTAZrZGkc7kP16607tQdBa87azD1flkxrXldTrZN/dZUFKZPxeIwbcf/eq7XCRYeaL3Eii8qawxCg4UgQ5OuGYRdKq2SBMmMu1g/FqQ+iYj/OaG/i5JWVI/xH+QliGh42YA2wjTcmdCFoN2ZF7nnllwHc45am4m6uZcmC9Fu1ja8E9MlYohpXXoIEzuENgA+N+MCXg/IVhAYXxMBe2ABi1YC3fgaXSv59dd6qN+Z5EFtmI0fFHbORKJHGEqrWvF+isKIjWb9Y5gLqfaN1XBZXLGkjjjwsavCvfB38GWKBlJpc8SwrS3ZZGf5YPrGlVCdL/YfuPep17Hrs0jc+6cYjE7Km0fwOcdKGsSg==; 5:Hi9rrq1dPWHhQyYwpZEHbZq82DA7AJoaTftsJm3aXrjIzzqPIwMIRa6goFIVTD0vkZKtcUSuJ5l8ojwyXk+shvhuE7ffJxFcpA1u/u+qvU9/6bBxnpv4ua02NqSdwD3CUZZns4qVjrB2QIKCqha0AQ==; 24:ejQt1ZAOOoSYMDB704QJas4zZATJtGbMCY98VZpgk9qyEG2g0ZpcSkholB3nSFvq2L2txJ2e9kojvM91UT7LXzi3iejavlJ12pFbbQAu7T0= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 7:5uKkNjxKuQDGQ5wSgEhKhThR3s/JbedsyF6RgNIMBueJBbUsaqkvjM0gmEQXyUxVz8eory7B1DliFyWQyrIN6lMNgA7JMl+ViM+5ZHaSWZRhEb2ZF1bx64B02NyaSwB3ylVWH/Fh01JZEsbymhOXmV9eKlhDGsBs19CPe693CEukjL7nauzTHKcUrbFXHP9A2DwQF89cpJC1/eH8Z89HZEJBJ9L21cejafbeqtk54gVIlKxXWOqqXY0V6OwhJMjaBJQtolmIk4pzB6AVccbHIg9PY8PEOkML+BUPJ7xxodKaF1X9c9VEenexOVtwO8uUOrQShfq2+aWvvmWaVVid7A== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Apr 2017 07:54:05.4144 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR07MB2284 Subject: [dpdk-dev] [PATCH 2/8] doc: refer PMD compile and test section from liquidio doc X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 06 Apr 2017 07:54:09 -0000 Refer the section which explains driver compilation and running of testpmd in Linux, instead of describing it in driver documentation. Signed-off-by: Shijith Thotton --- doc/guides/nics/liquidio.rst | 90 ++------------------------------------------ 1 file changed, 3 insertions(+), 87 deletions(-) diff --git a/doc/guides/nics/liquidio.rst b/doc/guides/nics/liquidio.rst index 9ffdc35..385786c 100644 --- a/doc/guides/nics/liquidio.rst +++ b/doc/guides/nics/liquidio.rst @@ -80,90 +80,6 @@ Please note that enabling debugging options may affect system performance. Toggle display of register reads and writes. -.. _lio_driver-compilation: - -Driver Compilation ------------------- - -To compile LiquidIO PMD for Linux x86_64 gcc target, run the following "make" -command: - -.. code-block:: console - - cd - make install T=x86_64-native-linuxapp-gcc - - -Sample Application Notes ------------------------- - -This section demonstrates how to launch ``testpmd`` with LiquidIO® CN23XX -device managed by ``librte_pmd_lio`` in Linux operating system. - -#. Mount huge pages: - - .. code-block:: console - - mkdir /mnt/huge - mount -t hugetlbfs nodev /mnt/huge - -#. Request huge pages: - - .. code-block:: console - - echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages/nr_hugepages - -#. Load ``vfio-pci`` driver: - - .. code-block:: console - - modprobe vfio-pci - -#. Bind the LiquidIO VFs to ``vfio-pci`` loaded in previous step: - - Setup VFIO permissions for regular users and then bind to ``vfio-pci``: - - .. code-block:: console - - sudo chmod a+x /dev/vfio - - sudo chmod 0666 /dev/vfio/* - - ./usertools/dpdk-devbind.py --bind vfio-pci 0000:03:00.3 0000:03:08.3 - -#. Start ``testpmd`` with basic parameters: - - .. code-block:: console - - ./build/app/testpmd -c 0xf -n 4 -- -i - - Example output: - - .. code-block:: console - - [...] - EAL: PCI device 0000:03:00.3 on NUMA socket 0 - EAL: probe driver: 177d:9712 net_liovf - EAL: using IOMMU type 1 (Type 1) - PMD: net_liovf[03:00.3]INFO: DEVICE : CN23XX VF - EAL: PCI device 0000:03:08.3 on NUMA socket 0 - EAL: probe driver: 177d:9712 net_liovf - PMD: net_liovf[03:08.3]INFO: DEVICE : CN23XX VF - Interactive-mode selected - USER1: create a new mbuf pool : n=171456, size=2176, socket=0 - Configuring Port 0 (socket 0) - PMD: net_liovf[03:00.3]INFO: Starting port 0 - Port 0: F2:A8:1B:5E:B4:66 - Configuring Port 1 (socket 0) - PMD: net_liovf[03:08.3]INFO: Starting port 1 - Port 1: 32:76:CC:EE:56:D7 - Checking link statuses... - Port 0 Link Up - speed 10000 Mbps - full-duplex - Port 1 Link Up - speed 10000 Mbps - full-duplex - Done - testpmd> - - SR-IOV: Prerequisites and Sample Application Notes -------------------------------------------------- @@ -248,9 +164,9 @@ This section provides instructions to configure SR-IOV with Linux OS. #. Running testpmd - Refer :ref:`notes above ` - to compile and run ``testpmd`` application. - Use ``igb_uio`` instead of ``vfio-pci`` in VM. + Refer to the document + :ref:`compiling and testing a PMD for a NIC ` to run + ``testpmd`` application. Use ``igb_uio`` instead of ``vfio-pci`` in VM. Limitations -- 1.8.3.1