From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM03-CO1-obe.outbound.protection.outlook.com (mail-co1nam03on0071.outbound.protection.outlook.com [104.47.40.71]) by dpdk.org (Postfix) with ESMTP id 09F9F5599 for ; Tue, 11 Apr 2017 20:59:20 +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=dJqWV8FlbRDUP+H35KPVxculL+YaY758qf8flxdrgAA=; b=BjTmoEXY5mT+r/X6f/PdiAhDqgeP4asQYtiG432MN57Ui1ZTJpppWVi2WoHkhWbbqpHeutQFWNF5juXGfiJnMKN/XstyRnh5JOt59QjiKKCF7p9HN8yhNxhTvneWwzPcSz0eyt0qjsVjhrOI2i2maqKthllRHPyw7hTAIcKAxvQ= 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.1019.17; Tue, 11 Apr 2017 18:59:17 +0000 From: Shijith Thotton To: Ferruh Yigit , John McNamara , Rahul Lakkireddy Cc: dev@dpdk.org Date: Wed, 12 Apr 2017 00:26:44 +0530 Message-Id: <1491937010-16553-5-git-send-email-shijith.thotton@caviumnetworks.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1491937010-16553-1-git-send-email-shijith.thotton@caviumnetworks.com> References: <1491465117-11252-1-git-send-email-shijith.thotton@caviumnetworks.com> <1491937010-16553-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: MAXPR01CA0027.INDPRD01.PROD.OUTLOOK.COM (10.164.147.34) To DM3PR07MB2284.namprd07.prod.outlook.com (10.164.33.158) X-MS-Office365-Filtering-Correlation-Id: de449aca-1bc5-40b6-3620-08d4810cdbcc X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 3:BBM9jrDD6zv0xEoJHK8SMnhWKpDb3TPv5FxunLi7J0aZH8CBGq43sAtvn4DUxslK8fW9oEfv9ymvUgve3xIkifGj+BhIM/8qjhDn/q+R9YyIuMsAS4P1D6rRUJyDGbIUSTFxl2rG0Ri+TH7vYMaBknW4pHPCJh669UzIIOyhWnlTXqgU3dBWuSttIXTDrHIv0P9/oTLy1H3/cc4aVgKhKzqz+53y60aUIb+zxDoNsf6y5D77Oy92kSU1lZ1jLDoeUSViuBkqyJuq+ln3xNtzap8WN3hs/Ho8qk+ZZI/dgkfZs1nbESCGBCB7QhlyYgTWv+l4qyoR6g4IEsSax2GLaA==; 25:pgz/TbC6yG6E6xd2nCzmTLs51Zz0ThPCGdKPVJ0pn8HFF2zH500OeEzPgk8xBr32mBx4gUCH6GmR68X4TNVcBREn7znljN/7pOx8wr7+HYqLPGLZoHx4Glz2J8c3Hl7S/hn4TKFUwAQiOs6m7Pkb123fcDGfQljCPuW1+0qg2GJpozGpMK0ovUSyspA+YbjAPww2gUntpTGgxTEP0bHnshXEhD1w+M9gqh6BUviN9hIUhL9Mpd4XAZYwBrnbjpgcvA843ejsW6Vk7IBczKPv/g3ysoibvD8GFe+DyywLXpHHDwF4NEXJCvxIw0PnImzA9Tsnqu0OAbpwP6oyd9pmwF+k3dMgcgqmd8P0AbLwICgdoTSAykNAHgCplesmV28bX/xSTveAl4NoeKZcuoZExc1H3T/UKfbtwAaO3zQkNdrTsGCYvV359ZyuCLJqmaxvl3CYTwjT50JCjTJXTRWlNA== X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 31:X8XHRG6YitvuMCAulJwVZhBzS/GThFDdwRBdRPdENzgYVOEXpCIvHVZ42xAQrhhLJ0AXWSd0wwyYsdAsk7rKGcHGj8/14H5WAQuc+AFMBSt1UuigfrWhukxL/xr1BdV0pcv09VUyu0LcqH/hw6DK2xrL6VKDESH1WNEvkN0R6EP1xCeVpaTEHlQG3IvsBWSenO1xKEyIrV6fk8uD7u4SdC2rEe/+s3EayX0RroSVR2stc9kUM9azf5UerQ88uIpo; 20:z2Yg0DO85TMlDteQJGzJ+M3ploiBCbRTO7ZzDzrOGtekbdzQNjHaDQHpiXV1vxZWMWa71eH78gBghhojPXUsbQiAuqZR1yt79mQMjtYnWHt+We0wmThLDpsRb78wCXXMlolSps6j51eW7FNjDOuio3BSCYD6VYzG5VMb0rFqiE2epa1fxiLtT+1EuPFIY/tJwYIdgPPBV4YTSsZcbP1RnH01mXP9kwsv9MJzc9lk7gxNKACsc0LgG7ntq051XpQXOitCanQJPg5C2G9LcmqNBQXoV7dQr3v+ex+YtXNFCQ4jUwsif/dO6YsgVLE7RCKAxhVaQE/IYgiWRNyPq7zhcvfrDsXAUfO8usHJhXnsFp0Rf+nwWrSK8jKyyP2euSSEddaW3ZDfzGHJDnr3CwT5+VuLY1UW243szhkVGmKLg/jTBonWjRIdIUkQJ6re0PVZ4JV44rlqLFChwghsxfBDMfh7t26ejYVj6PXNBq4aO0M16rB7BQBRA+SFvpMPKkqaKEwfEma+iRhuFC060DTCWcmnwk77h8RECZJZqn2d9Vi9BrSAAxbWRSrQxB+Vxmy+hzpvoA1IycwtjuH8OELzgcHdfg7MOPdPCE/2mLEEWLA= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(228905959029699); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(601004)(2401047)(8121501046)(5005006)(3002001)(10201501046)(93006095)(6041248)(20161123562025)(20161123560025)(201703131423075)(201702281528075)(201703061421075)(20161123555025)(20161123564025)(6072148); SRVR:DM3PR07MB2284; BCL:0; PCL:0; RULEID:; SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 4:MQeF3m9Kr430HI0HXLpMxV23fhENLW0zGCvnBddAh6xRNAq6t9S88HtHHT9EfFECQFPw08KYC9tSlXdtIYf2XtEzPUasFxG3kpPa95zNJFBPXicvx4NjzKrvV93EjKXEIuVmxh8t8xi+YG8DMqDsTC3t81k44qSsP8Wcaz6INb7d0jDiJIN4hDAol67Z/IpKj7czVG+2ZeI57BwFCT44MOUW5OL/YRobECfdc0hWToeqj7Gd6elnPDJa2Ts5Sy+ud62IQAUK0aRCcEvb4wuKyF80tLK4UFpAPaANh4w9VRyllz5h6x5xugCKhamcQ5RI2YuK/4cXUaxRJE3GcENnI9W+uXaGbQNJVAWw5r7kAUpDV9QPZsXhsZ++xTutjpN9uRvSV1eABpAQiNcv73xUIpbyhnkMshScICFxKJR4KqrIVb97Px3ONJNf357fcVs+XdYO9UkHcHOxUe7HpJ5FO/3351krx0iltMojrqY9CNQ6z/0n1/po82rceBwXZQYwYGEFUS2WHeGsEUD3wiqSNxSKOixCYSeXQQpVLDeWUifsRVr0rTmXz4GPv8nYG0036mLC8SNhKD16XfYfxdStBCPhCh4DodxNn/Ycbk5REDGQZ/puNFS5sRys5BcXdmihj4N+Cgp3/acbgT1hGaTwAJs5fUxZP/Qg5CIerr+WHonGuRd8SUA0oK2GWLOIAVH+DfddoCjvFIo8w6BOptz2qA0NOsrS7PDw9cWKa4Ji7GY= X-Forefront-PRVS: 0274272F87 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39840400002)(39400400002)(39410400002)(39850400002)(39450400003)(2906002)(6512007)(36756003)(7736002)(53936002)(4326008)(305945005)(189998001)(33646002)(5009440100003)(50466002)(81166006)(8676002)(48376002)(50226002)(50986999)(76176999)(38730400002)(5660300001)(6486002)(47776003)(42882006)(6666003)(4720700003)(66066001)(2950100002)(6506006)(5003940100001)(3846002)(42186005)(6116002)(25786009)(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:WevVFWt82xBNPEN4tjYc2zosL0PnhxbyF0AfC+Sl5?= =?us-ascii?Q?zP4TV+eNkKwCs7MXC11yJVtoc6dVWSbpTgaKGc20xFGhJh8XBcHvViPwOOQl?= =?us-ascii?Q?5RFxDv4KiSffK+zww9Cq4kpt2+vXb1CgJxeCjRNBXdcVBzuGsXke/dguHGJH?= =?us-ascii?Q?MokxrG9D0tj0xhW61UTsBTaFmTS0HBGAmK9nUC97QkRcmfjjJbHNmyjdTaHQ?= =?us-ascii?Q?RtOPF/UZM0GY3anDqXIsGnf/gri6glt6djiqdz960uSDoin88pNU/I2ERG5D?= =?us-ascii?Q?7BS9T6kfNRrr+ve0Q8o4JunFITjns+TTUBI2Ej+XAqM4sUJVLApHJmyBp0dN?= =?us-ascii?Q?o3qKb0J0FnQ/8KKzGsNUhdstMUmY3PX1bqSub0Ak7g+5fCEzs0HsLR6qv8KY?= =?us-ascii?Q?4bU/KQv9ytN8Mg1pQw+p/Irjom0mJLixFVeeCBjNpzppQkIznS6RB2ofOkHt?= =?us-ascii?Q?uCzCevQNHiq++K1ugXC3d3QnTK65I+1yuoRGNANb2iid1XvnNxpk5xbGHsKe?= =?us-ascii?Q?IRfiNbpqEoGsgxUg6y+GP2foSGEgCBFCbjclYormnNGG5yXf+mHH4qxp7P7T?= =?us-ascii?Q?Yli9BRVygqnG+tSpEW8H9JHG1RmGIvvB92cVgWcxlr/tkUGSXw+GL1RDCzG8?= =?us-ascii?Q?VFUasB13Wo3lGlKZVbsFQHHKzSMxJRKHZulov81zfH0c8utYkfSGAR/Hsi9b?= =?us-ascii?Q?t5UcY5/Bez3IH8sZRq94Q2Yhlke3KmctvXXPtuGWzOHkovXTWce9youbKkA9?= =?us-ascii?Q?eOAc+MhvhphvIdCzn43RYD641KH5gZlHmLBBFr6ISJL/Y85vAOLeGkk8d1vX?= =?us-ascii?Q?hDOCuKWwBQAKc/4u4IyECNX3lH7Y9Cb4LNIfwZ8sj7QGN9LwOFdqlvKt63Tt?= =?us-ascii?Q?1QVg8hx/ed+xEtYNdtjFrrm1wgv2NWusuPcy3vbH3miLkg8Q3oW8vG8FjHBT?= =?us-ascii?Q?MU8LY1Jwygdq/tER1Won59PRfCGQcWNsJ1BcxxBajRejQeIYU8RxeVFxMKKt?= =?us-ascii?Q?0JlKTiqnW8ynTpvGUQVjgN5w+52XwCIlso6TAGivBvUxbN9DLydjjBMyWFV2?= =?us-ascii?Q?lWkolI=3D?= X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 6:NJZD+AHBTNwTBDsm1nAeSB60ICPQ0BV5XfMB1hzKKpLOi5tgFgq3Pbgypu0WQRcS+6Fjdxv7Y5xUTAvk4ssIIYTAm0UIm4jXB6p4CIkzxg+XQNgzo2QIEgsn6jLru6uPJ6QXC/z3GuAkwQHKrU9sj8f57LSUN+e/wX8kgJyq9iWGE1V0e529a07pNw8V9gwTtzpUkJXtKct8V7Q3kyomoOptS8Pf1x0TJLz/0FsvOFxfGae0d7GnBUlVG7tzk9lToCGsspoxHFQTwzyfTQNrOjzrIZ9sxYoX0xIHUbHNgqYU23sAUQfqu+X9DdtwJv6XPEPDNOa9yNsiN2k73nEft/5gqHHuFMg3fTd7E6EYVyVqVeFhH0GnbqMMqn5oH9GG3VgRvZPbOFpGM8NztBdSFG/z2NrBzEZxiepPngIkRlDFc6Y3h6+Y/5zHDL37z4NisgITp5R1JAXe/2X2XbGlBw==; 5:0E+KIjjT4a8F9Mxmcj5zSfhGRkCTtogdwRJuce6w3uhJyGLne/PMWs00B0VymAoz4GJDfdGGmGB4RvS6li7R7uinb5t/NvadlvNd20VCiS6PUqkWfsfIQDW0D4oUA4akkRHcRiRfbJHTm/hxGahSjw==; 24:jFdKkQbhonEHzuO2u2ASZpmnRFHm1cNRE4JGOfrJuHsQ5b3xiQ+i+Zsc2orjnwfO+qBPttII1IzMM9FCn+EH5JFHn0ruvP+s0ol97ugAPpc= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 7:JpTyxgWOsu1sG9U3cXBsiEmiP8lTTtsvUcVVClwrx2SM7uh4IoABy+RLLL2GnMVCFf1+FDjLnvZp8vdLDlILjyyQ98/UiRPp6j8B5bsCLYXuGY+ykROMtmSWbJnKBDVd6R4rxz+WNVAqGkHqEnC1a+4DCP9KnZuEmoOtHYFPHY9jRs+AGN6b+gVZRP7gKZYnhLktyatrYXas2OU89lyUVAPFDz7OLK+o1quYMqinBNKQq7sW1HuY1993VycdEfU2TlpOuLHImg02xeCC5Kx4BmmnXHeQJFxiI4Nn+w/gaGKUd03Vr4HvYhrRlQRxNfpp5gv3jeV4ki/IP6laLvDOZg== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Apr 2017 18:59:17.7873 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR07MB2284 Subject: [dpdk-dev] [PATCH v2 04/10] 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: , X-List-Received-Date: Tue, 11 Apr 2017 18:59:21 -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 Acked-by: John McNamara --- doc/guides/nics/cxgbe.rst | 86 ++++++----------------------------------------- 1 file changed, 11 insertions(+), 75 deletions(-) diff --git a/doc/guides/nics/cxgbe.rst b/doc/guides/nics/cxgbe.rst index 308a926..a205b43 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,60 +235,16 @@ 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: +#. Running testpmd - .. code-block:: console - - ./usertools/dpdk-devbind.py --bind igb_uio 0000:02:00.4 - - 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:02:00.4 + Follow instructions available in the document + :ref:`compiling and testing a PMD for a NIC ` + to run testpmd. .. 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 @@ -334,10 +270,10 @@ devices managed by librte_pmd_cxgbe in Linux operating system. 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 ------- -- 1.8.3.1