From patchwork Thu Apr 6 07:51:52 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Shijith Thotton X-Patchwork-Id: 23270 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 12BB9568A; Thu, 6 Apr 2017 09:54:25 +0200 (CEST) Received: from NAM03-BY2-obe.outbound.protection.outlook.com (mail-by2nam03on0048.outbound.protection.outlook.com [104.47.42.48]) by dpdk.org (Postfix) with ESMTP id F1F79568A for ; Thu, 6 Apr 2017 09:54:22 +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=mUs2kRVF1k+KYA4+sBLolPWoUN1iH3UH2cZSEbzxiH4=; b=C4dq0tp9x9FRAZQ6r9ZV3BTvNpIbE6YLG8ZQZvb+TREsF3wJWnlK6ZKgl3GqOGe9gyMmJt4nHcesGvx4qTwj7z+sVI0liHx7h+khs2ENOhZNw8Ln/3QFFNJEB6O/Rcgo7WvFavx6ckeRxn4EzaGoM60PgDRDgxESSAyJ6SfrvCE= 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:18 +0000 From: Shijith Thotton To: John Mcnamara , Ferruh Yigit , Harish Patil , Rasesh Mody Cc: dev@dpdk.org Date: Thu, 6 Apr 2017 13:21:52 +0530 Message-Id: <1491465117-11252-4-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: cb1719d7-7bfe-4728-a3e4-08d47cc2224a X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 3:CnZQNQzN4joGof3LrxZJUNb0O3dHSY/51IbmlplhzPHSWYqMZON+CC92V1RhBie+0jNt91dyUuOUkbLCoE5gBBd51GkwIk7bGJ8bAcXyedBtASGdMRbZF3cGV8otTzFZCySZZPRohosMQMqvike3Dpc5nR+3h5UEInytOtbpi7geWoECu+dWNjPiynBTbhX13dgLTUqNQv7fPyff+dGAubd2OgFHU7BtqWVCfImGAtuDsy2aad/o0v/4PreEZK7oZGS1x2VKCN7FRYphV0ivCwb3AjJtLDfupZL22K+FB7fvEAAIJEyCO2jYZSeMoe0uHfS/Y/7+a4v0AKMbgNW8Jw==; 25:Wn7mDiyXlhskt8IW297+fCo+yX0l+u1Kmca6rREKvEr7aHHgAEGC7apDsz80RlrHDXi5zYdPywZCcbFuDNC9sGli5McPsB622KUhQej9w+ailQjfFdsuEMyp5YpPbSJVJ2DeRAjMMndUcZp63uaH0aeuAAGkRX4SjGjfW92RFt5VabNvXOnR6vJHvL+Y+xn3Z9L8QWbEXUuCP05gGfAOo0mgrynujav5UKfuNgceT6IRUy34q+VwbGdjx2jwCvJwC6tPVxhJKhXghi8s883bNT7Vf/d+xMHx2V1nWC1CjU3qV1/a2Y7PokrlJ3pQUHimk53dkZAx9YXlocVARKBaXqNbnf8e8qVikVyjgZF51K5xla0RGlGarQViyWA3viDuXWB799oVYBzSct7zTe4n/DYCnOVGZGDDlbPHCXyU9iTXf1easwskm30MBbwXC4cnryLuiIGSC7QKsfC94Z6BPA== X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 31:IjfberwzSffzfdaAS8TxQN7q+oABQCfKN8k7QH8biNA7LrHn3jQo5erYTZCdXWwrUigJM3DmZyH87bjxRgbiqCo1b/0GA12Dq6qdgu45KnwnpGBqDNC/rW6keL1++zTz8doDq2OBS1/Y9+NrZ9sxwZlPOZElx/JbSQb8dWLSPh/M/l2bkpK/ChwK/TMi2QikJjZSk4mr8eetzWcqrKrFboZa3eMrzPVL1zhgrUPu1Vc=; 20:3mZqpwrzaWo3vHwLD0i62qYRGb1ic/kvQ4V6d4C3wnv//5ywmUFQUry9RfAcHfME/4pRQU8i6+fZZUbNDHDcgIPTt7dd6znFy6QpGAA+uvuHqPvIcYRfhguyJTdsG/3eoQQBxNiXYip5wevuhifbAAJaBqsSkKJJ4SEIVuEr4TAHdk/fNloJVzHvu2DzdTDZTwiWFl2Gy9E7shfx4Vv02d4Vmtj6InmeW1olqG48IsYH+xTKXQ/kDlPXs//nFFpNyztNGo4tXbmEHBivLapWB5r3KuyLQ+jZYu810hkoTJigl/vi88sj7JzAZWaE8Ecgd27l0TmPkI8R0fJFJrZ82pa0bEtkZ6Xb0X5kAV9EPxHd/1T0MJl79iC7Gc/VcdDYJ4sQNqaeXC3gjV2MyaoncxYpC18XdWOiBdYDwfJo8/20koDNNZEy8GkRXj1LUasOGCXjcG1QzQNsQ9ejD5WweNz6rcwJI/in7eaYysV7nkwo7rVmCI3x9Alz7QlYLwWHR8/+MXl3QBOVrEHPuAdlWQ+E6aYAp9x9KJBvKxfhBBtBJ3IOvLDwIuBYnKqKsoRxQwvYG59WObU1tRisygmkr76k722DYaJfJdZI+ZY+2YU= 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:UQj7Xvi4pSBAK7+kSqYWH2LV7CXV7WhBwdN7K9m6ux+1xD/gTswVpS8lC/SrmyxXFukoT76QEBg1J1qqiemA49U6lr66gyVZ7mFwTY3Efa5PLgnLW6d6C1L8fHn2vNK8skp2oK0lQmk5G0uMYZze32rqQiE8iLjDGR2uWr0HOVnCirBMpZXA7ojk/rybmtQiraqCdVNbBkEb4URQoIv2y6bNtvcXfvitKly2TB07FmNS31fymujdEakZAe7wYN9pLXgPmDYZu7UbVY5GpC8pgFB2vMDjRP4WMS5UaEQ/uNPEV9PjiiGEGuZhrLYq+hkbNXYMTkgCnYbN//f8sjvjJurEk6WLxgL9ze61x8wK+yJHz/VyvC1Iy6w0EfCc0UgqFEvA/+KkMvxJnaOvwwTQeCCieXpQhdADNB4WeHTi3hjHxh8G56zkl3S1U83Dd+VuB1DLLpsmQspWPELdNEy/jltN/P635zMjGet4QbjuK3wcC56NsX64Yt+XH9jnF75gUGVBlUIofVVLjpgN06yDUAtMHivDTQlRzFf7ffSqOh9B2aE4NP9Q8ji79zFLS2bTM5EgCapnbPeD8vNH2Pul1CS6J8SDBz0rwOXkMNhetIvxe0GAiLdip1N9lYPUlaAhw3sOxznGgj0VCjLk2p3XXw0ys9gRWhOKUfrCB+SMNUCtaZKdd2aWbWNblyjKWIHl 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:LqgrJ2XOtg6JW4u/9VdAfvkmKRr5o2S0SvoMjyQJm?= 9d98H2leK3qJXlqRTCL5DEY+VK0KV72Yynfm9Bgve0voUJMi4dK6GvNyK5Ot330WFEhT1VrfTy8ReSx8m0Mw2LuFNnbsPHayAdj2o0mEohUpijRdzaYcL8IU5HNa7/yxMSh9GbXhObpwsEfJtJYp+2wSGSTz8B/BQ3qeD9LH6Xl7eidxQ+VCDhJyQYkdspwac6fE3jLfXEbV8ct9VT8/pgGBGj899ipcpcl8tx1l6C3EUcTRcxsZtbSj6YTSq4yNqNpIZFE+9d1YQt73V3tghKCCbCgXfo6Z1xLiThgMnkkqSSwJrrGpp8LnH2VD7mZUbAAtWFroVSUlRhNTrJOb2cOVeN65Oy5yBhrsjzRrAYSmjvJt5Qv8JbBRlU572d2TYZP/wRuauoq3NKlZ4+Ym3ENyZ6vSIYSo4RWMCEeeBB0p/TUTN+zdymeg3TYELS6yJuGMNPPGkxlHTDuoiGYqBWB5MzV3cuXEMbWn4aIvl99zzfawBC4U19rMKnL/RjB8NgU7DcHbHROahnRB1bGOnwXpVjCnc4GzU+DmR1aAu7uZcZ9bOHnU+PxGKB0M15E59RiRUIM3q6KjPkaeEio1suS2iqkX9hdBQRvzuGNhSxd1y+m8oOeMcU6AZgC4odyabLCs8bsbk85D61uXrOsZOM0GhQIjjD3BWylXFo//Ug3T3i6sNnJKoppK2vKDC+FeS5jVOYvM7+ro8i6axeM1d5Zbg9UPfln/xyiHthhA3J7rpWvixJKgTkBQdZ9Hls3rJLizKpPjaDC28V99xYzJWS7ihS2Y4ujIjv9RFp1o05y4lbyuUbM1qq+TYQzLlaI0qlCbRgUULqKMxm/rRq8bg7ZzNbw0FHiLX/0sPV3S4qZLCxSYyMhEChoObslFv8m9Zh/w4RVg/0WALOLB7GC6QUyzD3e4N03FFlUDcvXagEAzxY8UP9ePvqTuhVBxn6HIr8l75IoLUr6zw3CZkaxVOAU3v7rIn5SinT0NrmG4NInf/J1TQxDsZUlUhFYr5UA3Bn1lSar/O1YD5IEb5Sw81Ml X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 6:BsbkAb9YUS2OhpXyNZwPgWuWYyM3I+4Y1Cwks/5evykhhlPWbfzJ1+ooMNSzJp/XRcxiVs1M+Osygb6Ou0xV+zNYYgiLBETpHGKWFNTcSW2NubKbMW+ZHA2LnflTrYvLrYQeVaRgxvAwA/aS0+leamLONanzfYJJaevYy6Be7qSz4Gnye6Ak63wNAKElQUT6uzhksNjp+ZERPHNWJjUL2+I4VD9rJZzk8MltA4MgRo+XsZL62+3HgbXhKBIcxv3mtJo/GNsw4kXpNSLckap0FrEivVtW/Pska9BlW15Mme+byQRQYJ5tx9jXW994SYIlwqRsGOq0wnE1DGaLQigjTZqGZMzVjYkdP+p6YsPNpMgW5qEp9o7IanwBnwCCTtaFEtE+JrqofNYBEwIlV071dA==; 5:Gsrl0ZlBFdJHbLdpWjQRRI3mCdMM4E7Zve5KrMLBsP5ZGSCfkR2geqlzuU1xZle5qSsJ5hK1h/2b7iVYx47UJdX4zJVXha2lMrTwSE2Akt76Q5UnLRv998X1xDg3Yrm9ajSbEyTjijfqQ+ljQIB1dQ==; 24:InRYXXrTcq2ooT1MPDmdeDcF4MKQlA0MVA6yCq2/sfw4sSBxmFuWglXlRI5m84jPaxkCvOZIYc9aR0Tyon8tWFLKsfP+VNt5FuuoQL/rAgI= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 7:K0xMtReRNvazgd1UyE+S9ecu4AP1NjpXQ3mDh/vvPFQeytjv1/6eHaJUIAIHNQbyr/bF07jZIacMquKgKmYeypoBv+jAPCg9im7GpDRCXrUcUzfnqHYKSMRTzYg8xZftR1G2Iw7lkJiGPLfMPRGbO6J12TPEHfjTVOoJVn7v8UPSOgNbkPWsI8TduxD59py4zTzxSRRt0ZVw9YO+bKvf2e2ChBaQ6oJBImmCEIrJxG/P4jlYDPb0jwgLzxrMlwm9bNfJ0LyAX96pfWZFa+kCqRl7r9AuxqhSJxNNd4xNgr3x50knl7bvvCGLCinnQi53rAqmAc0iQokTR+q8MaDb3g== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Apr 2017 07:54:18.9394 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR07MB2284 Subject: [dpdk-dev] [PATCH 3/8] doc: refer PMD compile and test section from bnx2x 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/bnx2x.rst | 139 ++-------------------------------------------- 1 file changed, 5 insertions(+), 134 deletions(-) diff --git a/doc/guides/nics/bnx2x.rst b/doc/guides/nics/bnx2x.rst index 17780ed..4ecfa0b 100644 --- a/doc/guides/nics/bnx2x.rst +++ b/doc/guides/nics/bnx2x.rst @@ -123,143 +123,14 @@ enabling debugging options may affect system performance. .. _bnx2x_driver-compilation: -Driver Compilation -~~~~~~~~~~~~~~~~~~ - -BNX2X PMD for Linux x86_64 gcc target, run the following "make" -command:: - - cd - make config T=x86_64-native-linuxapp-gcc install - -To compile BNX2X PMD for Linux x86_64 clang target, run the following "make" -command:: - - cd - make config T=x86_64-native-linuxapp-clang install - -To compile BNX2X PMD for Linux i686 gcc target, run the following "make" -command:: - - cd - make config T=i686-native-linuxapp-gcc install - -To compile BNX2X PMD for Linux i686 gcc target, run the following "make" -command: - -.. code-block:: console - - cd - make config T=i686-native-linuxapp-gcc install - -To compile BNX2X PMD for FreeBSD x86_64 clang target, run the following "gmake" -command:: - - cd - gmake config T=x86_64-native-bsdapp-clang install - -To compile BNX2X PMD for FreeBSD x86_64 gcc target, run the following "gmake" -command:: - - cd - gmake config T=x86_64-native-bsdapp-gcc install -Wl,-rpath=/usr/local/lib/gcc49 CC=gcc49 - -To compile BNX2X PMD for FreeBSD x86_64 gcc target, run the following "gmake" -command: - -.. code-block:: console - - cd - gmake config T=x86_64-native-bsdapp-gcc install -Wl,-rpath=/usr/local/lib/gcc49 CC=gcc49 - -Linux ------ - -.. _bnx2x_Linux-installation: - -Linux Installation -~~~~~~~~~~~~~~~~~~ - -Sample Application Notes -~~~~~~~~~~~~~~~~~~~~~~~~ - -This section demonstrates how to launch ``testpmd`` with QLogic 578xx -devices managed by ``librte_pmd_bnx2x`` in Linux operating system. - -#. Request huge pages: - - .. code-block:: console - - echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages/nr_hugepages - -#. Load ``igb_uio`` or ``vfio-pci`` driver: - - .. code-block:: console - - insmod ./x86_64-native-linuxapp-gcc/kmod/igb_uio.ko - - or - - .. code-block:: console - - modprobe vfio-pci - -#. Bind the QLogic adapters to ``igb_uio`` or ``vfio-pci`` loaded in the - previous step:: - - ./usertools/dpdk-devbind.py --bind igb_uio 0000:84:00.0 0000:84:00.1 - - or - - 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:84:00.0 0000:84: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 +Driver compilation and testing +------------------------------ - [...] - EAL: PCI device 0000:84:00.0 on NUMA socket 1 - EAL: probe driver: 14e4:168e rte_bnx2x_pmd - EAL: PCI memory mapped at 0x7f14f6fe5000 - EAL: PCI memory mapped at 0x7f14f67e5000 - EAL: PCI memory mapped at 0x7f15fbd9b000 - EAL: PCI device 0000:84:00.1 on NUMA socket 1 - EAL: probe driver: 14e4:168e rte_bnx2x_pmd - EAL: PCI memory mapped at 0x7f14f5fe5000 - EAL: PCI memory mapped at 0x7f14f57e5000 - EAL: PCI memory mapped at 0x7f15fbd4f000 - Interactive-mode selected - Configuring Port 0 (socket 0) - PMD: bnx2x_dev_tx_queue_setup(): fp[00] req_bd=512, thresh=512, - usable_bd=1020, total_bd=1024, - tx_pages=4 - PMD: bnx2x_dev_rx_queue_setup(): fp[00] req_bd=128, thresh=0, - usable_bd=510, total_bd=512, - rx_pages=1, cq_pages=8 - PMD: bnx2x_print_adapter_info(): - [...] - Checking link statuses... - Port 0 Link Up - speed 10000 Mbps - full-duplex - Port 1 Link Up - speed 10000 Mbps - full-duplex - Done - testpmd> +Refer to the document :ref:`compiling and testing a PMD for a NIC ` +for details. SR-IOV: Prerequisites and sample Application Notes -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +-------------------------------------------------- This section provides instructions to configure SR-IOV with Linux OS.