From patchwork Thu Apr 6 07:51:53 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Shijith Thotton X-Patchwork-Id: 23271 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 1BAABD1E2; Thu, 6 Apr 2017 09:54:36 +0200 (CEST) Received: from NAM01-BY2-obe.outbound.protection.outlook.com (mail-by2nam01on0079.outbound.protection.outlook.com [104.47.34.79]) by dpdk.org (Postfix) with ESMTP id C891F1E20 for ; Thu, 6 Apr 2017 09:54:33 +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=t4WPuzur+1NMetXGWMg8TfSVRmAObPE2yVg/VDo7fzQ=; b=Zq83sj2f0Vu4rXEsPnBR9jFHP5J6OIlsu2ar/jG3crbqCArCEERpkOnG+gPJhXj8540pEIhhy0E3TuNSxdsEItveywPqeoXwrtSfhXoE4SDDW0HLdDfGni834dBSqUwIxyCxFkrVdF1UPjq2IWwtCua8UbiydNNW4Zr0DrBTpdY= 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:29 +0000 From: Shijith Thotton To: John Mcnamara , Ferruh Yigit , Rahul Lakkireddy Cc: dev@dpdk.org Date: Thu, 6 Apr 2017 13:21:53 +0530 Message-Id: <1491465117-11252-5-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: fed2b149-a07b-4246-b307-08d47cc228b1 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 3:oZ0moNN/kNByPpH/nE5f/hOY9fPvwHkHash7kE24DMV5Wnn4bxae59z9q0USZHwBrPdGF05lVfhcEz++OJ9q5JxZhKDDws8w4ZiR5KsVxSi2jOLxiC4ZwWA7wfLAp/wgQKwEhnYxE7p5kg+Q00iPQdd4umcVV4wg2wiPflMCE+AgNVL+/7KmtdM263rnYhApM2P1Vun5gGPFBzvNHpgCexhR1mUMh1RFZFmLqQgS5JMqztjDeosXDKVpDxE1nZlnEbNfrI+qxHBBlYMKSNqZfwuJlO3I1M6jnqsuTBPAQlUFWbS5T3DwwD26wH+YFFPxrGKv5wX9OmY1qH4y2tjb1w==; 25:7dwGtIAZzifH0vCmXTQX8mza0KABdx6V4BkSXRbbFvT794yKX1k6hHXNagsP8wtKyzUsC7s5/qJvyxX8PnxiYGBH8VT4NCO13Wcr6if87Tnj+69+HoJNv11xFrV06PhuL7RrUbFvTA1a4TZ2UOAQPGr82TlPsfb3kZDi2r6yo+zQFuubU94g3Z/h3Yj0UKlBkFfxcMyHYbbXD9XC4AP52ZLlgNv5ZXEsWqRp6V58wCSjqZ+QeviR0kDst9okmFYAzv9g8RAkndzL/IQTNbo6c3Ws99chzUoYHxBk8kW/TjHVMM690KQNnZOsSl0FUBTxMwrZ2Mg+ctL2xno2PM+ImxXrxuj+wM3eUStJT6wZzuS2gwnbGyo8zpqcM5tprnc3uzAfTEbIjJMYRf6Sn3vwB3IDwnlzIL6veJKZnEVrQV1cyJig4KrQSaHn71HaPMPZh/XwhIcL6qqXcFHQcP2kZA== X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 31:p11V+Hz3XOOcaWi04cWDY9pKWlflG3LkybJTIhopnWPw9+skIk+hTFnI6tbH+MY1E6KKaEbHzm5Jt56L/+X+Pn7D4rGhQr5DesL/u1fDieuo+PYqckQzZIfZ3k3LMePVtU7zCkehbk487usy85M0ClbnTEOZDT+QKwSSg/xsY/muVs7irzRL7I+MDJGO/q51D/+lTbSIG2BfOy4CfcIox4FgeebtgTU16NSP3V62ICGZJRKDFGzb2EzJB7H/T6fhwmzSSKLYC/UHTFl+EADgVg==; 20:gu13N7XG5gOiRZNRuUJx1m3RK7XD/IYrOTGOKp0Nomji6SYYlCRQIve0qTZafAm+n3kXnKjkZjljOVx8GPUVs8z2F1es5R8HmtKJdxPVS/hWkMHNJIa4O+UPUun1zbo4g0wxed1QYapoEp79VHBVnYCveypU/bfDJCuYQarobbKCE06PKq+G3it+1R7I6hvtHhPYwEbKNCWLbroC3VfnTZe+BD6xTuSm6vhql800yc0A5vE6TQRs3JqLS8oJi+z/sTjz7RIieHLDMNIZ/lZcwPbQYjlzzsZSJfjWMvm9BIimcuegzdQbX4lOgfwGiZ0EkB8EbE7Eg29s+nukt/3n8OXw3xHHw3tofB305mZxLJIjtsYe9YSqB6hMWAu2R1iWRFoRmS9ONjWNkh1Jmsnj/iyD4Zn/WUiXk2xYYNPEKnpM92Q4/nbK/OPU0tM+dYL/gGQvmN3CJMfylT8aPHUj+S+8dSL1dyrtJ6Fmo1qgY6iVzMuTi7IWZ/vMdBH7atQQi+Z1IBfqvQmgm+6Jn8i2Mwn8lQia8fxv9i0dA3Anm6/1Ll7QS88vvkEL01zkAtoLrj8Y0CHZTvA6pD7wvOcChq2KZ911nG8ZsNZGlKQ54K8= 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:Xl31CDlpfuApDOmoaubSqbUxPHmdlo81JZvrXJph8KBeE3w1EOAAH+oW94BFhEAkeJS1ZmnWYMMG2fdgoq6XSNH/N9np8L4Ek0JloP665t+/U4dtU6TE3bmBiDKrDyStflYqMRvbbFL6jLnYAiFCAd+aHDCr8AeA7EbsTd2xByULY+UWIXofeFGyCx0FYQAhGy2ANy0hXtz/HS/DEfwZGiA2roT9wWjl5M7bWQlh288nSqAZvIhMTA0MttquymTPiKPl8mJVtZ/89MbyleGKd/Dq3mAuBtb2AGPw7tB6U/dZHHW4wJDXUkI+VHbqL4fsQjr96pk2ymx5a1T1ijNkMROXFYEbrM9b4LKiXmiTAQwXiyM3ResKLAwrspNI3oLGrlkRsBPf2+fCLenPFtCMRuu1z6gprzk0jnaHqw4lJB48W0UuVLU8WFh1PCy2U6tqb7O3aOafMk5h6eaABX/qFMRMqtSFWjeqk2Fq+l2v0VQvT4vvmf0yOD0B/Ih3iG4Y0UkVwtMJNeBXzeLnMB+XTjX9NRsLv5b9hxnvwKWTOJohUKfptlCwq+o10qzIvWbofHIsLtZiWYjBKUy5Z9MS5nuOdvEhwIeo5qacJyxxlgsjasApOSxhyXrdbrptKPQuXk2heVhJd1F+y0FCnTBPYB6IAY+v6JR4AHBZKyNvJiyj6M5kkd0i5fuJ6oC1vFm5 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:PY+YOe5wOiKBYMODEiDjoIFhIuT0xsMqxAJTHnV+b?= 6BJ/yIS23P8A1vxfwkgnRLuVy0jtmk8NVlSN0Q65xcDkKyogoiuCczJQKs7ycdgoFAB7tfA7tGQC94fYOOcq3hUdWAUjRwQEjb3xcxs4vZdjOP+eWsIK6PJJVWJz+LbhoMYtrqhhuVWRxwA7NFAmLHw87qn065B/u28xfSx9iCtwJPWTk8YiXMSDuAMlQPkbv+vuD4Ih7j+DvrKw0MwobJQ/T+nbClLJl2uDG5gB7EXXwelzDBKxZ9SCzhlZK9aDb1tDL4K0tz/VNi2mCuxP3dSFUXLw7P4BKrccPEH0ytDNhFIuOJ8YR71vCABX7YltOT9Ch7AG54bsnEwssSI49Hxfab4NQP6jqPYh9iJ33Vp9FV2SV2iLD1rRC1T+O7i0KKpw6CvMdgk1d88RMSfkUlr2q9nHctW/sPuGS9CClaAzh8sJNNLqfJgbrHxFl1x8a+X1BkMpMZcwLCv0ZUUHEh1sytMX0gpl7+cMDQUpjgjtxdUnYph3OeRuqgHimmuWQ2IH66UI5ymtMJiLYqG0lVdhCsugCLWe1d+VhLOLuwuTR6TrXuIF1MIFdh6ZffZlUy1b6Ys27WCEohpLt7MTe/ZXblsb5q73RIbLCWGJmfiOoQv4RQTQjwTnfp/loKX+pnhhHbYb4VCN6hJZC2nJzGy9PJyzNIKIDQVeQ4jnjNczTVSOMf9vgHtvHDLsRcxe5PN7TH/S+PAiH5euiFLIDeTsb1qUKVWLRyxDkibDJXcJ7PM2IXnKFKz1SeKFw9JWS7gFTcu0F4VF3fWV3eqjFBR2Ed8VKpk+93HLJOBC/dSa8ZL/qAOTwQKvcFRbyl6OxfyjTuyN1TjxrN8r8AwartSN7rVSoacv4pBaaSC5WQwYqv8ot6UKOClC3cdL200vxG4QyQEBglE+9azpJWexUkUMpLTi/GuCOfcFzpaIQ4Chgf4Oy7seDQG1EjqvNaUDcwajsWdRNuS7pwTLnN2lEIQgx/YYSm43/6ObhD0FOGiKsgej+4umSWXtu96tgKIIPQ= X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 6:ryxgZJbpdmOGLFamrX+bmoeTXffR8zWggaH2yiyqvfpW1dFmBlcvzH6GruiCfW8kf1JlU4vEEFWUGkKjFrcC7W7QOd4OdIAh6CBCSDo2r679l7EJg2CkVrTOAz/guzNC2KUbJ5UPJqexORfO6knfeJffeS4VheMIH8jZTE8TNIW8wkcFoC0xI1c/HKxlBIXTOEo9+i5rZuhaHTzRW4IZtGKg89X9+hLwQbmsKlJCWLDrvz5d3YVfRIePsoiLpHNoTPjlx+2mVdEcyXdE01hoR4SZ+bFvsFWW7q1vy3apg67SlzkIDciWEM1TZb53p8y1C7DgXu95s2HjqLHmTv9hfuIYaXp9pCkqvEqNrZsF0NuiXUOBAq94bIrF7Sv4eyI+YjBNufcSyVmJtBtNVgNs4w==; 5:V05eFjEDmnttySMy8WLJ3HhCdJMV7jV6B/BgRLt6O1ci7Ztfpp3O/2+zgCFaGY9bBGcZgljBZ7UO+PGe5QpVRZde+ALt67fz7LzopR3kF4g2cSNyTJ034l5pORY/1FWKLbk2ewh+/+958R+RlkklZg==; 24:ZSYOYjSJ2SaLR+wufLPHtKiiGEnIHSSNBqzcvBz32vtXtpNKy3wN3mh0kyzqjIHgCLnC8bojxF0hH4z+PUf+c7FrcEg5tTNTxXqob27exRk= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 7:7yEkevloJw4r8W2MYIY6OkeGaI2OMWNSybAlS2jteOZQ7PYO3NnQycbqSwIkpo6vhIX9qdlY4kh1ymasaUmOJzieixHGKAQt9GfmakF+auSnJbN9vpjJxI2LiJfu6YdM8j8cxk2EOzZ4Kl4XpL1O9TXTdMW1lE3ss3weWNh4bVIFGKtzX12GrPk3pDfFX0oFo7JI0rvm5TXrDC0cMz2AtlX8c4UuJ1wQPEbe5cD5PkUbVfpamTa/sNrdeXLT7ZfP107Whj5QeKuAdxaImqYuJjkGAKowSasWPracxFnoNVRPKeULDibWSrNMjtvyFxrp6p3xckelbwXLTVWHLvHeAg== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Apr 2017 07:54:29.9394 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR07MB2284 Subject: [dpdk-dev] [PATCH 4/8] doc: refer PMD compile and test section from cxgbe 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/cxgbe.rst | 109 ++++------------------------------------------ 1 file changed, 9 insertions(+), 100 deletions(-) diff --git a/doc/guides/nics/cxgbe.rst b/doc/guides/nics/cxgbe.rst index 308a926..d193f66 100644 --- a/doc/guides/nics/cxgbe.rst +++ b/doc/guides/nics/cxgbe.rst @@ -125,24 +125,11 @@ enabling debugging options may affect system performance. .. _driver-compilation: -Driver Compilation -~~~~~~~~~~~~~~~~~~ - -To compile CXGBE PMD for Linux x86_64 gcc target, run the following "make" -command: - -.. code-block:: console - - cd - make config T=x86_64-native-linuxapp-gcc install - -To compile CXGBE PMD for FreeBSD x86_64 clang target, run the following "gmake" -command: - -.. code-block:: console +Driver compilation and testing +------------------------------ - cd - gmake config T=x86_64-native-bsdapp-clang install +Refer to the document :ref:`compiling and testing a PMD for a NIC ` +for details. Linux ----- @@ -218,13 +205,6 @@ Running testpmd This section demonstrates how to launch **testpmd** with Chelsio T5 devices managed by librte_pmd_cxgbe in Linux operating system. -#. Change to DPDK source directory where the target has been compiled in - section :ref:`driver-compilation`: - - .. code-block:: console - - cd - #. Load the kernel module: .. code-block:: console @@ -255,89 +235,18 @@ devices managed by librte_pmd_cxgbe in Linux operating system. modprobe -ar cxgb4 csiostor -#. Request huge pages: - - .. code-block:: console - - echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages/nr_hugepages - -#. Mount huge pages: - - .. code-block:: console - - mkdir /mnt/huge - mount -t hugetlbfs nodev /mnt/huge - -#. 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 Chelsio T5 adapters to igb_uio or vfio-pci loaded in the previous - step: - - .. code-block:: console - - ./usertools/dpdk-devbind.py --bind igb_uio 0000:02:00.4 - - or +#. Running testpmd - 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:02:00.4 + Refer to the section :ref:`driver-compilation`. .. note:: Currently, CXGBE PMD only supports the binding of PF4 for Chelsio T5 NICs. -#. Start testpmd with basic parameters: - - .. code-block:: console - - ./x86_64-native-linuxapp-gcc/app/testpmd -l 0-3 -n 4 -w 0000:02:00.4 -- -i - - Example output: - - .. code-block:: console - - [...] - EAL: PCI device 0000:02:00.4 on NUMA socket -1 - EAL: probe driver: 1425:5401 rte_cxgbe_pmd - EAL: PCI memory mapped at 0x7fd7c0200000 - EAL: PCI memory mapped at 0x7fd77cdfd000 - EAL: PCI memory mapped at 0x7fd7c10b7000 - PMD: rte_cxgbe_pmd: fw: 1.13.32.0, TP: 0.1.4.8 - PMD: rte_cxgbe_pmd: Coming up as MASTER: Initializing adapter - Interactive-mode selected - Configuring Port 0 (socket 0) - Port 0: 00:07:43:2D:EA:C0 - Configuring Port 1 (socket 0) - Port 1: 00:07:43:2D:EA:C8 - Checking link statuses... - PMD: rte_cxgbe_pmd: Port0: passive DA port module inserted - PMD: rte_cxgbe_pmd: Port1: passive DA port module inserted - Port 0 Link Up - speed 10000 Mbps - full-duplex - Port 1 Link Up - speed 10000 Mbps - full-duplex - Done - testpmd> - -.. note:: + .. note:: - Flow control pause TX/RX is disabled by default and can be enabled via - testpmd. Refer section :ref:`flow-control` for more details. + Flow control pause TX/RX is disabled by default and can be enabled via + testpmd. Refer section :ref:`flow-control` for more details. FreeBSD -------