From patchwork Thu Apr 6 07:51:55 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Shijith Thotton X-Patchwork-Id: 23273 X-Patchwork-Delegate: ferruh.yigit@amd.com Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id 7B37AD218; Thu, 6 Apr 2017 09:54:49 +0200 (CEST) Received: from NAM01-BY2-obe.outbound.protection.outlook.com (mail-by2nam01on0074.outbound.protection.outlook.com [104.47.34.74]) by dpdk.org (Postfix) with ESMTP id 5C853D212 for ; Thu, 6 Apr 2017 09:54:47 +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=aYGMgHREJPmIJrFEc7T9cSJlY9ramBzo4kjQuVfW5bc=; b=RKe6JgPxtNxnUpZRjxYYyBlsU/IhQPEkL8EeR8ETHJKpc/Ff8JedO710w29pdptWXlFjtxSy6B6u9UzOAtiWIf4CND11o1qahue1IevLYZ8aTULu/FDy0WJKpHGB1keYXrY/Tb6ZHSf7+mlvL0IVEsN5pgc6eGEv/4wVRD2VNjE= 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:42 +0000 From: Shijith Thotton To: John Mcnamara , Ferruh Yigit , Helin Zhang , Jingjing Wu Cc: dev@dpdk.org Date: Thu, 6 Apr 2017 13:21:55 +0530 Message-Id: <1491465117-11252-7-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 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: c1112df9-15fa-4d38-31de-08d47cc230cf X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 3:upXvkMicxA1bO/ezDw1ib1ZLGjsupVcWAh/MJ06uDCjZd5zCq3xLCZ+y4i1jbKUkrqdMF4LEN+RzFCz969mSQdJGltbVgR5axa7OtsdO2j4ldZ+48bjblX59JqXO10pr3HwwYFpmjNmd8NVfBl24T4D+BnjF6b6fC/dpl4bADIeMw67aSBI95YyCXZGl1JsZk2OIfUPw28EGWYNwIgDaNThCIE7TWp4Z8RxVtLiJvBlXN8ZFFzoHL14imafUAefgf0xNvJwV7YxTAZva/XLPoa+eBkkP9Kf97mT+wn3o1vWXRZ5gNUWsbWvHwcqYEK3DZ15UtroMKr/gclef+xE9MQ==; 25:twIXujy0UKVLlEmH1+aV73lEVoHmpCG1Y2xpLmh8OHSkNxqpX6JViDnhKhTevSFdITAp8USaowMvUS3WRryn+KXWK7Ny8xJOEtrt6gdQ9AuXfXe6g43MLF2gtgy8blcFiwpO6QnLxw7oeHRRwJ6nkOJ0ga4UeY7bTpgFdkWURp3YVN3FUV0gxmlMpbPWBz8nHgON0aoL5AZOHsUfjF0XWIqYb7BpLrm7ZUoKx5QO+AhJxph8oBEn6c/oLLqqnlHjWjyMQi+3oh/dFmL2Qz8RgWB/Ex2teWkkWDwd43jVqCRcfGuQo+ZfFMr1rD4hjaUY1bHeb5UVuMKPdljTIHxOusCx65h1BubNlId+Wcqg3OGHTOl5xtZj/vlxpeMTbSWFuuUI735WRqIey8oOiGHtk9tIP9iIhDuALl5mRAFNWYfWK9iUpJi5qeAxTyBNnrlCm25coxHNjGWSK3kQz6d9eQ== X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 31:WaBl6iPWmrEr8Yl4tIE3lr6TCISMA63hQHq12Sl5SuaxlgMsRWgphyiN8Z4p9fdBgPD5EQ8WAux2sHtmNipivAfLx27pQ5bWv5r1T9FMZ2vPdFQU+cYgCL6CANzyiHq5S3xw0GSlaHa3yFKenc7Mk57AvyaYj4J5lV1H54pFa/5JksX4DXKqr9ERrFk3cWWvWjWmvQd1zYSbVPcj7JSQnjezWMB8vLqYLCaM3fF8TRV8eWn2dqTGEGKpKhFF1R1seQZWxjJ56PIjKmLB7WaAbx59jQ3TjkF06JMh0QDTudQ=; 20:PkYb7OsP3j1MJHj9au+PwC2exg2CDJ6vPdej7us6lmoYWmcRh1zT2hVoBhR2uUu5MB9G3uT7ZirRj1q3+OI0bEKUrf28Gd3FDCloZzo49lK9w3fyLC8xR6iJWPNtrlnSB14s8PadMH1B6SfpaVhI4mYqJIL6TpH9ud9gLC0/SYY2vSNI0zGjBApVKa7dfwv9GeawOds8bdsiGOM7erNsKfD0YflGVrb4Jj0Un8+Iw6zke8LnOY7r1ErO1QwMGwCDY2C4SKRtF9d0NJ27MkkZYCJX6odmkfFZP0F3Pojz44e7fyXJau5cdpZHJ7dy4TOKU0yU3ooQpgZUd2kCpAxuqC2bTmgKOot+V8QeDvDWu/1FZFXsHSeoOhs5uebASVdOifNZe4rhQKrvLUdRroZdaxVHLbUX8FR3RdCCfzV5cTZJiQhUZl1r+yQ8k+lo2S86qq6tw2pQ9QJoMHd4/4GodNGLQpqv53ThYK5LGQLfEGfQEJBarQhw/7zrgTfU6omdPGdTtnpDY7tffOj8A0RhVVL+4RfJr1xoqSKVhkFRNEwpWGX6r9kiAfCbRTBYMQYLKXI2WaXsmyDTK2OFyzWe06qcU4+90h4b5tMU8a0sUWE= 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:p3PPZfys1nHXVktHY5ujgkFumwcumY1QXbM+wIZh0tLtePIuX6w7a2jCsM0CkR7rUEDulpGJwINhlBHQvhmnkuEvreOLuoF2abO6UYfSKbqvvYFHgwdVc+0t6t8Z7RCe/LX1R/OlXtOp5vNY9pJzKpo9thARzD7a5Skt0gFHwhdpgpd5Hn2g4ll/5Z0iADCcdy7F4KIcw2PCF6ChmfDB4qbaoLHkQIoR9Z8v3rXwusA9t1dnE0dvvl8fV5G18outi2vKNpd4t2sLjqw8LdeuelWz/u0Y0Fjp34qlbhuBq01+gFJNp7heQulQgdj5qBMI4y7CFU4i1Bsp/esT8qKe5PN/XP1AnHTtUJM0nJJz//7rDJlwkJUvfMzgnlLH7wTfZdl3OEg/pTPwPwLAkiBwQ6Y4EvAbzwqRkLyp3PKhs1WSV1p8SBnhLxMZSUsmSo7BzTtO0lq8CvaXB6sYg6Bwq3oDHBGhDaihI7IjflO0gO398a+9sfa28hWfbncvWXXZC+OtLTMyk7Ow6A+7ncgFmuX5lY6NHFS5qno7gKcs0HOEMOJaHCrIO27V+KiQA7Uk/xRg6T7+DaVFhUXiQegbSFuiU/K4ArW7hpkRHSjfQzhv9q6ErXDP8wSaZTfatc4kvxhoedFMJw6gqCFYlMGqHVXJeuuR6fwuWfAHxfEu9aaLsJSJERkJNmuSbc+VV+AI 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)(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:kEPw4p0kO7yzZ4mt9LNNdM6HM5fDOMKfmPevSK/MA?= TokS2xPRTs6AHZxnB9Ib/PsV73x2A9wZ+xILNOiGy1gpovS8BFs+7mN1satyaLBxMXQ6fRfjDCCMLdC2F4LGhGpOP9J2y82kXo+oaT1ArarePLub7g79aX1x/pXWS7lXbhQy0yIRCk3hoRlhihKCTg31ZjnoXNq98+Ml8V26WB3ZleBTlsvbYQqFeA05kuVJCXGSCtK16uqGpjmTo9OyOTD9FM1wMVKViJ+w6NDE1QTzvxBxZpj9fLkQ1YmhXDzBgfS8pkcBTQxBP7BM9iLtxBTkzCNHjnKtIzEE1NDJfxnV27ZHULj0PLx5RGN2l8Rp5THUhdK72PqHgayuuAm7LwnihmO4vA0fOiNijcv+PJyuogin6o/1lZ6igPDd63qZWnmpqFqNh6JCW/4CeLV/bmMPfaZOIvTXmhCwx0nxQtLoh6BMYH/ijoNYRjKKdhljWA25dKEQgT0DR8PjNFyooSPU7ipbspi+iSVI0hZz9qkqjIkSIQ2eVi39BXRhduqMIj/tLxFstwSiDlqfLIZA69mO7lSejB2p71+oE64hfFVm9Imu4x5gXDDYJ+q7ycAUtOdiNa2IiaEa8GpR2oiLrHcDunJ1+kyIm5gEszfehsEahsZfGnVmtqxa74MVndX5L655ym8rdx9pYtyg4bzg4/9AVgFtCcfq5JR7Yk9IQ7u8c5rPQEoTt5KYNBBUgaFiiSH5bqL7xNAcvyytXUnZa9oqL3yHsDloc5Ybk8q0yuJXR+n+v6MYQeC65kQfK5fuKMKitNoRaw/4gD+uzuP6uqey8GSIHMih8311OQVIETtVzew64WF9fnR3geW73tN3pOvltjnEX+Oc7lu72JNOkEWjf1ngbDPbk2Tq0DmOEMrWOwrB+mxjaQ4GJePhURIyA13akB41+p2i7DB1doqq4qMiDugsO8iuvPrOTX0x6BjNy7RXxa38VXD44jXFSV6QQ7aVkVJ8fReRSyZQQnHTcqHR+Eh0D01R6dV+Uqr40RwzFAmNfTnrri/Gk69zVFVBZw= X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 6:B2gaa8TPJ5tY/YPSxV6XpSPxsgdUJTe5LYrSSF6KUCV2DYm9pRjl6xp0llUC01LpG8Miu+05gWJhMizdyXoBY7C4o22Y4eEVKUi8jRQa5NnEmD0oPq3uliQ5v5eiurkWzqZXLQjOjILSzN+h7e8iQFroEyA/+Sb6LJUffc3HoWU9mGkXFlRK9dGLus5x8qjNhal/iDqFK2t9oERaCquwwbdVTdGuKAIn2crIouud5uBxhjFsii6zpb6eJjbAa6S5K/WzOFBMq6qXM5OKbIyqvR+BmyQ9MpTdjbypcPP2Od4X8jWU08eAlxuJrqE5bOTVBavrbVDxnbrl50pN0ltRupvXxKXRsuCQ5KdvAKJS86fYqgTw9Z7YQHUOgkCwz6xBa8mNDLCqfw9o4auhOV/PNA==; 5:4iWHJbYkRPdSf+xfy6yRdnPjfPKHFzHJmpoiEqmmI3nBXKT3dpS1UQC7N6uy0FZTqXEK5AAb2SiiGF5lBkAtP2n79QxynhZVKNtLQPE6q4BdEOdEX9EpyZm4rO/13jXZ1sXQl5HETQMeJso6Ceb6AA==; 24:rt4ysMoSYoI+8Kfot18Hinsmh5bQ5vbJS7nQUu6WQ8YvfUM2y15G96KSP4SKNTw5Q6bUXakC+Fnfp34AdlE9QIk//SxISIfy+dbCRpQIBVo= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 7:TzDbUYjMPm2XlvTY45tJI6cEx8BxgIGeyt+1yOQDMbNVpy//bp9bozahqJkJ83iXQqoj6fYIfZesNVB4wj/4ClER4nDAaEC3z/dw7ZF20swW+xLS82JqsO8fojtzkGTTMJkkuwlgwgsa1C/OQjmJqj+0n87eVlR34fXYYAUqZS2h8QXl6zOfypVK4lUMzGXG8sm2TAOGON8R8tRYzEz11vcXaQmZfv783QPMxvVjo2TWMwJuhhgI1f5auxd/hlDHlEdso4dk9V7jqKUqc1zVsGhNgRUHtX6vicytPLDrr76tmTybms4/rMKjQ6/slAmP6rmCIXj1sVX9BM1gX24CrA== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Apr 2017 07:54:42.7788 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR07MB2284 Subject: [dpdk-dev] [PATCH 6/8] doc: refer PMD compile and test section from i40e 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" 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 Acked-by: John McNamara --- doc/guides/nics/i40e.rst | 77 ++++-------------------------------------------- 1 file changed, 5 insertions(+), 72 deletions(-) diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst index 6ae1d46..f31e5f0 100644 --- a/doc/guides/nics/i40e.rst +++ b/doc/guides/nics/i40e.rst @@ -131,82 +131,15 @@ Please note that enabling debugging options may affect system performance. Interrupt Throttling interval. -Driver Compilation -~~~~~~~~~~~~~~~~~~ - -To compile the I40E PMD see :ref:`Getting Started Guide for Linux ` or -:ref:`Getting Started Guide for FreeBSD ` depending on your platform. - - -Linux ------ - - -Running testpmd -~~~~~~~~~~~~~~~ - -This section demonstrates how to launch ``testpmd`` with Intel XL710/X710 -devices managed by ``librte_pmd_i40e`` in the Linux operating system. - -#. Load ``igb_uio`` or ``vfio-pci`` driver: - - .. code-block:: console - - modprobe uio - insmod ./x86_64-native-linuxapp-gcc/kmod/igb_uio.ko - - or - - .. code-block:: console - - modprobe vfio-pci - -#. Bind the XL710/X710 adapters to ``igb_uio`` or ``vfio-pci`` loaded in the previous step: - - .. code-block:: console - - ./usertools/dpdk-devbind.py --bind igb_uio 0000:83:00.0 - - Or setup VFIO permissions for regular users and then bind to ``vfio-pci``: - - .. code-block:: console - - ./usertools/dpdk-devbind.py --bind vfio-pci 0000:83:00.0 - -#. Start ``testpmd`` with basic parameters: - - .. code-block:: console - - ./x86_64-native-linuxapp-gcc/app/testpmd -l 0-3 -n 4 -w 83:00.0 -- -i - - Example output: - - .. code-block:: console - - ... - EAL: PCI device 0000:83:00.0 on NUMA socket 1 - EAL: probe driver: 8086:1572 rte_i40e_pmd - EAL: PCI memory mapped at 0x7f7f80000000 - EAL: PCI memory mapped at 0x7f7f80800000 - PMD: eth_i40e_dev_init(): FW 5.0 API 1.5 NVM 05.00.02 eetrack 8000208a - Interactive-mode selected - Configuring Port 0 (socket 0) - ... - - PMD: i40e_dev_rx_queue_setup(): Rx Burst Bulk Alloc Preconditions are - satisfied.Rx Burst Bulk Alloc function will be used on port=0, queue=0. - - ... - Port 0: 68:05:CA:26:85:84 - Checking link statuses... - Port 0 Link Up - speed 10000 Mbps - full-duplex - Done +Driver compilation and testing +------------------------------ - testpmd> +Refer to the document :ref:`compiling and testing a PMD for a NIC ` +for details. SR-IOV: Prerequisites and sample Application Notes -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +-------------------------------------------------- #. Load the kernel module: