From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM01-BY2-obe.outbound.protection.outlook.com (mail-by2nam01on0064.outbound.protection.outlook.com [104.47.34.64]) by dpdk.org (Postfix) with ESMTP id 1A2A1376F for ; Thu, 6 Apr 2017 09:54:41 +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=71RPgyCfxIUzCc7FzRdSQJr61bCqwwYL2x3GYWJYel8=; b=bDXTfguRWPOGKdYWZkzyBpDYlGu4ftW+OUFbQQchCvRaxItxZ8BMDaOaML0m3kQQ1WcJPAyHP6K9UJiPMjhmQN+7u1X/TFeVgVIIJ67wzDIQKX+RrXD3fMHkr5SmIPfV6CQy2jXLrNvTSn0Bo0sBIZU+pm4vqaGRW9LLj6ll2lo= 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:36 +0000 From: Shijith Thotton To: John Mcnamara , Ferruh Yigit , Jan Medala , Jakub Palider , Netanel Belgazal , Evgeny Schemeilin Cc: dev@dpdk.org Date: Thu, 6 Apr 2017 13:21:54 +0530 Message-Id: <1491465117-11252-6-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 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: c090c175-9469-4e38-55be-08d47cc22d03 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 3:6XibqgJrKVgX1kzh3DXFSNau8sF1+R6/QOG8NebbVJulVZ7zo0lwQSoarIROwqIhGk8yIjZol2PznxcxW9iV2/PExS8WEAEI86RCMA3W1/g0gYwVnYBgQPo9nkBwU0cvpUWmZ54r1RV1V+hN5uqO60KHX8zUVYxI3fKwBnQSqf9+qaYgndQVWQv7HCRL9aFMJ7YvDfJRa0MA4S/L/2sG38Pc8VeWbLSyuS4dxIN/9f5H9K1LIoX5bv9Y6/icXx3YlHUSTttFtAOvsWrRNgOmF3Blxz8uZJog84D5iaHg7k5A5ZJV5FMDkhzH9Nd2WTB1GrYL+rLneuA1hX76L3fAYQ==; 25:4JsyyCoOl2BLD64lRBHFCnTF0PI36pqeep6dn5neHyrO+3TiOAWYsJeF6mmrxFg4jtRdrgspGzG2juvlVR4sfUxNAheDnW/8wKJRq894rSB0ioSHnl/JpBe0bB/86d+1HI54/BKCDUqe0rR6vkGovlHwJjZRRD+4rGXnokhfEhxUdlwz1Gw7EO8JAR3o4jjd7u5n3Jet//Yq/0UigCMsmqn3nG+43N+DSQRFKFbEC9zhK5GcKQozffjpP/ldDoLH9/jPi49El2kO0Qiu2ipAshQ0Ssj6axDfu9jKXhgdcc7hMjC+16FEBzbVOuGdOpzI7QFuG0T02xQ5MldFQMB4KUNQQ6ZwQ+Ffzgm39bkxJvjTISYLSc5tNoLJb0QT6Z9VZyg1WSH6EM6scWmfz4bqMk3FgBQ9YQCXv33FyiIEiEb2zLM9p8lpqv4uEPtsuidp8y312u+9XsPnvoMN81G1Ww== X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 31:AUjlOad3g/3rWULjlAr6tgA4RFZBBGE079xKDe+rIpmzgocnVT7SSgRiy6TZV/DxjQ/UnwRpLNbjOOK6Fcz35YYlmt/B4NOrXJVPnHv6M3O8LdDEgUb9GnFZ9ZFk2QsjBzmHRO/Gaox+cIZZudUO3phHpwCY8Mr1anNgSGj1r5v1m3LPgNveIB3USYOAv1Ln97bOjrHYmGORonzJFNJ27Sx+XT04EQCeU4sq94nNjO8YBmxORVw7XwhcSD5z/p+EX0dr2nlXGwYS35MehPW1c/hYrxgItv8FFKoHoeR99lQ=; 20:qfxZVXL59hFKy/LUHuEeAlKZcZTMvMB9YT56yu3ZKtTE7M6Dx3Emdr2Vy7AWMo3484r0cr00dTHDhJ3OQRKKpSn0sqPN+zQNfMkwSw5onOOBRzFHErg+u9lQFCaXcQ7kTVdrdSmwUddQn59LsWFEunbHUsCfiF1tUWMmDC8mHDhl5VzRbc+Kihzrv549rGD4D1m5nWgT2alzmexg348ULitfhNvnYEkXuUii9zwdPJ/jtqu6MUMAtwsx1FECetpvuz9PS/B6Zfjnd1qPCnl0DLSuMlEY8eN2Ou+q9NfX2HJSN3mx3abEOk2QJlxd4qniwUigc1PTG1xFvq7o5Gza1/4Dsjxnu83sIrOLq18RCmtYpBwPVUaxNIPFtC7advxdw5y8se7s0oxbog4A2BBltajLbTVbmiGEgFmSORt/f0LK+6yJHtYqos9A3uOAYjaXHZmG4Q1ufjlkSYtnoL6NBK0AjRea431klQ32VgBXusGrmsc8bdyBKC8BR60E2CmSvIYVyhRmR6FQwfFGFHPJsi4lOR0Rce+Itit2Geya9BJorWU1HoFL1+uJs1avtqyxauNAW+ewhJrwvNQY2z1lP+zDbhFV4Sq9PTXsHg8/NC0= 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:oWhZyhCU9hOK2sWWmVwahqaLpsb7hAoSlEnY7nB5HVhUUOXCxtC+OYaEFsja13CEz+r8Ik/jN6kawc9J3i6pT3MhAomP1eawJqObYQzUlSiyW4oRPtNjbAJ+0N6mvWyn0NYc3qfbSQRFmwE5t3XPU/Z4JipPdMbz0BjbTRGrXgXlcIt54Rx2e79f52akYn7yABYw/Jz4xY4Gd4hilmjb6PzZCht4gwRderuAZP+kH9HOCCbKR4lqxVzmpnF/KBhxnRWkxI4h699ZNZ5qSTIdqbzbpVGaV0+UfbRuqaC2xzcG+2XFnuqf5A85SylH4ABnbBtKOIJR6MK0beXZVsA7sEBqv0ZF91l2zXt2OMqHxYCdRw8IHkSzWrdLBi7FL8Grf39qb2EvrSNj3GE1gb2yhsnmTvHdL2GB0PoEmEf2LyzxX1vpD2gaJOztasevggFaynht124LygSuuoNtm5Sxh6SRfxE72VljNKAciZdSW5Oq6ln7Yu3NflPW+Ko27w+hDTiZNnhjuGsW4aLg32+gehip2TBZ/v8snTPbZLR5F8sZRcmV+sPWZFhHLU1pGhSDKSMmju3HFT3mhr1wN9c9zAwdD27beIwqEqMSR5dgKcq1hR7RDllWNUfWAxiWCUgskoiy4ORnpUxIYH4pfazwibeoJlMltd0UaQvYKj4S45U752xrbMu5wvDDwxPjQXAh X-Forefront-PRVS: 02698DF457 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39840400002)(39450400003)(39400400002)(39850400002)(39410400002)(50986999)(76176999)(36756003)(50226002)(48376002)(6506006)(6512007)(4326008)(47776003)(53936002)(6666003)(25786009)(66066001)(50466002)(42882006)(2950100002)(4720700003)(38730400002)(6486002)(6116002)(5660300001)(3846002)(33646002)(5003940100001)(2906002)(7736002)(305945005)(5009440100003)(8676002)(189998001)(575784001)(81166006)(42186005)(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: =?us-ascii?Q?1; DM3PR07MB2284; 23:hxd3tofWFgaig8kYqQwl8k8FhPLZervY7irMYl3Qj?= =?us-ascii?Q?gpldPMFAg3GO7kt1LeqmtJxlv5YVXKikOH+WsmVKXlG0tkvsqanBlDICItMo?= =?us-ascii?Q?60waDoeRY3SUe3oHIq6Bhk+vz2TqtvzXg7VXENoIpAv1mzBrjayPGCgC0fOF?= =?us-ascii?Q?DIEOM8pIP6Op3W9cBEc5CX/FkpwvY3/FVjJMnRyIGl6+7SJN3aIna9f+wEh9?= =?us-ascii?Q?iyoijcEJTxwlaLrASAobSfjXJmoFaGUom63tUvTn3EKJ0s3NkfaARPVLzwBq?= =?us-ascii?Q?6VACpmOntzNaa7bLAvvZJ0JME7JY5jRDA/BWZfiJercHGyN2saxZcHm7qlg4?= =?us-ascii?Q?m74rL/SwYQ7N8LPzcJL4l4/bJOpOpbN0y0lEpaDwP5+YYhX1l8XMFbhTE904?= =?us-ascii?Q?kTxaf7a5s04VhVu1O7D6STHmNVlZEA9dEj20S2cgbZ7hBX2Hy+mnr1ZcnG6w?= =?us-ascii?Q?o0cDdr3th1R5jEIGAjLMitnVv8Qg0DPcbnY7HmpxRzGsmjrmu6c3tJ/EAGcT?= =?us-ascii?Q?RtX6ti5vCShnxsR1S9aQhtRap/7F0FubrNbZ6K97yGecHhc+xWTvWuTLAwbb?= =?us-ascii?Q?DxpFIDKQJ384HpPR11uG+LfdxVHgQJGCdRvtYfK85/isXvyQH+NMWoT6f/IH?= =?us-ascii?Q?IDkO1EQIsrWB4hKT3MUY8Iuufx5OxX9vFLpy/Dv8cJ0oKhUij4FZ8sp6SOI9?= =?us-ascii?Q?kdsU9owaOdzbTm48ei7XDEPKZgr3mFRuxsmic0VwrLg2tiA5AWn+8M+7l0ns?= =?us-ascii?Q?jNZbgXcj0XOGbBYLX7Olj5goU/ZsBpUh66tQcf6+nGtmUj0PRoyvEvoMKmvN?= =?us-ascii?Q?3WshhkanLhX35oBfzSUfhcS6QMLHkD4T6oU3IgKQH7DAuIXwgIfEYkKq/Gpz?= =?us-ascii?Q?7gdYKI5UdWofKZp5RT5sUoGXbfxHYelnDA54lRhB20AfE8jWHgwKdd5gjUqI?= =?us-ascii?Q?Y2SFaun/rIOIkfbqJFTBpc0tFAIg+uLY0pLNPekjRNAoCWsc1rYUsXk7jDQx?= =?us-ascii?Q?6iFgQk1yBWfFbTe/njsLjJhY09J50SmS2rfM43SDfCzpXqkVjCWdYt3r71jy?= =?us-ascii?Q?dsrlWpi+g5EWNwuj2y7iFJapa2I?= X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 6:9oSnT0e167hPxwvjzgNIl4QgSqByVD1f46i/zhTkBzl030GWLJsBrZqB+TCN1qCxu8WP7ushfbQ3nXH9APsBhTrbk8u3O2iRw8GMAGU9QSyLYqKI0Ea03GQqmLFTi/FNqNzz2H2WqD/EdB6FDgaJWN78wvs1kMyNC1hVR/Mjd8dWhBEEwKlPRYukreuJsIyY/Xig48Z7Pz3+CsDdCFDG4SMB8Ap9qwm0JTTuNddmqDkMjMh3gfSuFpn74bxVb8kD3tXqQXD3Z8f+x642l9fzAZPtuRFUUlOhOS93YQ2hbZdBuMyFHYsqTCgXSL1pZwlS5osxAg2qAKkJqxckdiwOO7A94SORq7uUEiTepP/a4pEZoQgHZ0qgEHJizlrSi5kbNwuBQSieKmQ12r5I1F7MXA==; 5:HwmSm5bG9J3wVkLRodAIBoyZ8PUm67NpVBMivozPtOdmMkr5JOtTLRTTeDTYlf5vpRyqe8+2rghB/mhNhhnzx+aUTNXUup/nwZ9hhrNoDpuH4o/sN9cmoh2SpVKNZbjvA1QVHH9LYGZo5QxOX9qkAA==; 24:u+ixbwonVCWXQWDlYbldty32/TvmD0mGu/tDP2mPQums41/M1YFbJz39RPsZGc7Maw7YhVTcXNSagyIyoePG+Uliq5YkcERQW6Zlq8ZScow= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 7:kfzwGhzO7vNYSq7+mf2/6xrFgiFVOYfakEg36kfn+hzIX9OhiWQB0XdVZ+XypcXN3Wzm0FBYKgZCGKR0YsVV6tV2yj1xDqrvPl0bHRHpXkr6KOJmN6Q2oeCxBYZMsaLwRTWinQyyXqxcTMoIxQCDVd/xpv6NYueRCEEhi7H4zisdJl4LBEnoi9YxSHb3KiOaQQwor539BnmpXH0ZWRNZdovvyggerutRw4KpgbIBr8VwUiLcNlBaJsxo8gOqqhpu5Dr7wFxfDc8igxKb6i1fly0wX0RwBAem1sUL1NVRX1X90qUSUeVtEs4OGkbcyhbFdWTp5MKTTe2ENqtQXlzLOw== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Apr 2017 07:54:36.4947 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR07MB2284 Subject: [dpdk-dev] [PATCH 5/8] doc: refer PMD compile and test section from ena 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:41 -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/ena.rst | 66 +++---------------------------------------------- 1 file changed, 4 insertions(+), 62 deletions(-) diff --git a/doc/guides/nics/ena.rst b/doc/guides/nics/ena.rst index c2d6b85..db95e78 100644 --- a/doc/guides/nics/ena.rst +++ b/doc/guides/nics/ena.rst @@ -140,16 +140,11 @@ Configuration information will be the minimum between the requested size and the maximal receive/transmit supported by the device. -Building DPDK -------------- - -See the :ref:`DPDK Getting Started Guide for Linux ` for -instructions on how to build DPDK. - -By default the ENA PMD library will be built into the DPDK library. +Driver compilation and testing +------------------------------ -For configuring and using UIO and VFIO frameworks, please also refer :ref:`the -documentation that comes with DPDK suite `. +Refer to the document :ref:`compiling and testing a PMD for a NIC ` +for details. Supported ENA adapters ---------------------- @@ -196,56 +191,3 @@ Prerequisites At this point the system should be ready to run DPDK applications. Once the application runs to completion, the ENA can be detached from igb_uio if necessary. - -Usage example -------------- - -This section demonstrates how to launch **testpmd** with Amazon ENA -devices managed by librte_pmd_ena. - -#. Load the kernel modules: - - .. code-block:: console - - modprobe uio - insmod ./x86_64-native-linuxapp-gcc/kmod/igb_uio.ko - - .. note:: - - Currently Amazon ENA PMD driver depends on igb_uio user space I/O kernel module - -#. Mount and request huge pages: - - .. code-block:: console - - mount -t hugetlbfs nodev /mnt/hugepages - echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages - -#. Bind UIO driver to ENA device (using provided by DPDK binding tool): - - .. code-block:: console - - ./usertools/dpdk-devbind.py --bind=igb_uio 0000:02:00.1 - -#. Start testpmd with basic parameters: - - .. code-block:: console - - ./x86_64-native-linuxapp-gcc/app/testpmd -l 0-3 -n 4 -- -i - - Example output: - - .. code-block:: console - - [...] - EAL: PCI device 0000:02:00.1 on NUMA socket -1 - EAL: probe driver: 1d0f:ec20 rte_ena_pmd - EAL: PCI memory mapped at 0x7f9b6c400000 - PMD: eth_ena_dev_init(): Initializing 0:2:0.1 - Interactive-mode selected - Configuring Port 0 (socket 0) - Port 0: 00:00:00:11:00:01 - Checking link statuses... - Port 0 Link Up - speed 10000 Mbps - full-duplex - Done - testpmd> -- 1.8.3.1