From patchwork Tue Apr 11 18:56:42 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Shijith Thotton X-Patchwork-Id: 23574 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 686052986; Tue, 11 Apr 2017 20:58:55 +0200 (CEST) Received: from NAM02-BL2-obe.outbound.protection.outlook.com (mail-bl2nam02on0049.outbound.protection.outlook.com [104.47.38.49]) by dpdk.org (Postfix) with ESMTP id AF0302986 for ; Tue, 11 Apr 2017 20:58:53 +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=AeH4e/JRmGuHrxr/tfpe2A2rXR11GHXY9CFDItTMBNk=; b=BjPjpdvixsWleKzBVGzfzG/VgYqcM31m1qFT4sorrjnoal684fE9HAtqOPSIF7FGYdFnCv5RKpAso3m4V69sd48CAa596BX8ujtprpVuqIOU5A42G0ZTwPVCvPhrKGDBTRAwry9CIcmffFxnAPM5p8+DIva3fm9Eb4JSlezbPLI= 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:58:50 +0000 From: Shijith Thotton To: Ferruh Yigit , John McNamara , Shepard Siegel , Ed Czeck , John Miller Cc: dev@dpdk.org Date: Wed, 12 Apr 2017 00:26:42 +0530 Message-Id: <1491937010-16553-3-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 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: 81b26aa6-3fb6-4a4b-5559-08d4810ccbb7 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131423075)(201703031133081); SRVR:DM3PR07MB2284; X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 3:cCRoKAIS6ACXAQaMluYwZ1XEp+9vg7XeSbptqEdHGSOZREJrx7XFwiBO+R488Ai1vFWVJdZPbyHmhl4cJuFhGRaLd+8ctPTqgLSGqlnyXVPtmtOUgXyl0cnIMiGHXShrsHfCSgvYsix9pSH7IuH2RrMZC8Sa+XL3VBeeXsLw5zMcwlr5mBgl8UdxymplMHo+o5LwXBmApYTYkt+Pje5yZ0SZY2HRqTNAoS8hI0i41PQyIBmT/Ea3kLaRBIwWIZS0O7lrDspTNoJHZz5Lfy4bPpsu28gwKTc2EQ4sy5Hfd3CQm7RqdZjbI+XDA5wZ4H3snOTIVqFtxiyRcjjA1NtBXQ==; 25:2UKoy130VE/p3LOJYt79N6oAah4LWe936sZKLDp+PYd59Amswi/2+FlsTAl/Ngn9Dti8Dc6cRfpFnVir7fnJX8r90TGCoCrxHRjQkcPuCjA4yapD8Sm2XXiAkSJQIgpPN3GUftv1zcyrE8C2L0ysTjuXpHBSfnSYYMya6vG/ArbOxN16eiYNiAHPPNy+NNKisEWcHWsiPDYuILYfYgYJfocz3SZT+dFfA6vEHQNBCgA23rdAlSs1sXSYdx7qlcnCV0gmGxMkC9T2IYO556ThQBPmlSJYZf1YrjSmI4pGSiYYDv4GKzyAlXwRW1j/EpcEXXdPZAd+YD4gOJqnEQOOXnq3VrcuIuLH6fFsCKP0cztoCB8sHeYjBSkalWfbXz+2wHOiGx4vf0pWswJr7sJvSOkws7aHCJi2VQnFYSK2Mh+sJ+X7s3SjwX1ge/D6+/O3xfBQ7L/CXyc/9HcEPzFmZg== X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 31:xulPFRCmoe30qMSNkXH6y6AuFLswVyaW3U7kG++9EAVwY6v4OU/zQ8R4J/IWDzT4MeZdBZwHJTixL84PQzkYY4qJxio/wLUt76Z2roQkFP02x+mxLrvUyCurSa/kEhasnf2R0ohzAXr7k1NdXvF/jDOBn70ir8nj4dAKk4Xxznm2VjL5ld6ACJaEEtyy6V8IYVz+BW2OM+4S8qakM+d9VO7ZPcJpeJiqijhUCIZEL9K9F1eGDS83eZxutW7tObqQSxPCZA0sZEsgGXtpHpIazQ==; 20:0qk6LStE1T64ifCcBObT3S4PfPOokNabWhBkQ5wnH7kEeiTxlL/U6QTzOkpPrt9qgJ9tovJzKVqeDsvbVLBtlQZK3Unimj/Fr9Y36Ornq/Ep5kig4JsP0qKtzjiHpuAyjB57I+pmHMGUDfH8BGKaRRPDMA+QLoJXRwMtIlTqxpZitZRoGOrXnL5sGL6NrAqKSGE75wwJ31v1io83yJVvT9Ah28/tAeYqnvDKX1Nr6F9e9uDjkNwb6k72t62xNtWvLiOtSEqoC+vZ1gj6pTqIQ+MVH+l7UbCP1Au5WDpW7Jty9RSAQ0JpJbYBIsQRATSfmO4UKTwehh1aNpf35sx7sowhjOdGSMlJJonNwp+cXNpRDTy7mf6gAwYH3bgMbk4i7jajGUPZeToIMA/vbjqWDm/6aiKjkrIPzMw4V1W1XfXuhF07/97bdOdRQPE3iNf2CljOXJ58u2l9NG7ZgdjEp/73X91sUXQZdhfbzyhNIN25SwlX/Ceo2GXA0NREM0TpSAZn/1eIwfVyw9q1k+sKB9FEr9oe9kruPMI78PYU18Y3ZIRsL1576SpJDQuXKCNW2Y/K4bztBPIzsEbvxL9eK1DMPowhBIsUujc3qXiMlPk= 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)(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:/F8CZnG9TUWIQbUsiptpVCCeDfrHDYtnK2I8VvxkFQ3FmvN620CbXTmWr2ECmbuIWUCtvo7JIoCBnYyzXLWen1Mfxmm3UwawoD78mgPPl2Z38aiO6C6U3bSeWrqfkClhCrZhR2ULOJ1ZGWE/vC2f3wD5fR2+Wn11Wy7Us43P7qI632I58NnTpQQuMnP3Hw4Fj7TcgToInfXhGJaFK5PHD1LrP1BQfEsO7X2InE5KsyCSZjF/Oby7MAoEMKPyyn09VTwOBoVMiJFvxrxLvcCPLZ1BqRjo32ilpgGoNjtzg3ag6WTXMoxIpZIh5WhmNU0tp3qJh3/9kx8jcu9HWQwIqEETteo4fmYC9M6luSBSgJKSmsy/kzXAzx2+zJ00Sj1Yw9hB4j8yEoThXKABoeAbe76Gdx61O0+A53nZbOdSF/9rZNcGq6TEbUaTOW729MYio1TnTlShciR7Ve3WR6Ypmk4Q9Grr6fxkakWhAk2Y2b6FONTPbDTQBeYjJVuzP/xxQJZzAn9mejlXfWYfRQqpMGfCi30wYdXQNvLDbv15qek1MpJ8Qgft5PoKeXChQTu4Ps0x1XXEN7Zw8Bd7LIGuYsmjH44m3KLEMHZu7CBDUPZ3yEODi0rc2ONTwEPIYJA36OnuHQVgE3Uvlp7ee9v/cW/2WfN89ajcdRWGoFDccsbJBRQjVE6lmXjfHtuREsoc 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:Xvys16m4sa4JwrXTRAEHmSPRhxK/BJ3avCj86do9V?= 90+Jbaten7BbIMWOJUZnvw8fFOK+c70iyKqk7UsmsIZqyDgHOFbT7XaXVZjORYssqgI+286wPSERZeQa/gC1NYfi2kwQWz5nI0VdBNXj9NONHne+w/agqe18eVnUadxOaYq96ofT3uXnlch5UEXx0D6whnxOxbA8y/yxtHUhRP87XsH543ItyAQ4/dzGFkybcApzWr67e1xj4dQCrQtdbvxzPZwJPLG1Wpc5OKs5gHzi5lfK3CxDslwRiPKAiVfsTCHiYs5XLw2vM78TiI/giQ/SLOS7nCGTT5x40finXU5X5qloKDzn23iRYSvq/fCLfP4oPkWOEopfw0dFOf9MlPGrH+XIY03OOUkqHaCUsllMhijphAlAp0TFU3HMbbETV6idZ3/eIx2ZVCQPUXghq4GERK1BIga174xxr/ITrv4pFNbBDslxa5WPLrtqehRsa7WRFz1PYTHNHBYBpWTg/VlJmgJVH2c/zbPmcZy35NYqWGU4c7gI6A6eN+xNjVqMKXGAvKJ3DuqNdLzg6VohdfKQWT/x3nXkmargpVyR9TWLBTWdQeIiFJNynZNKF1LrEy1v1EfWKSO9EnXSqc9X6jOTJCiTclvVBp1KXsyKyvPRx5CRepzA+WJ7jJm7IhfARFcHYADSVh+abVHqzBhCO79AriOwpcZoa7M4Wgup+VVVHHVVrotIsq8UCFsKxz8dvfAbBqQhRSfFICxJmEL1slIXvJGQGEZrvrQG8Ln4S66OIc8TBYWkQn4ICfVM91XYKw1pg86+cRYVYWbBCuEUcvNx47RZfDizQY6FgIYmy1xIskrgicoLlDRVRZezA480je/D17+5KvcvDxdWihfKxwgagzFPdOziaeevt6CppPt1YRdiSFE6nXdtSnfmNQrdc0eV8CU6VI3VBRVv1XwQoe0B9AZlAh1f/Bh4cQiyL3KJXhm0Xnj/siL5aB1LzDGTNn9r/B6emRDF7QGy68sOJwgJ/qm5p7IxajtyySq+Db79nJTyFv6FXpHHz9vRjwhBNE= X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 6:rPCrKvy04Wi48HNbbxiQEs4qHdaQvP4f2LroGeIzO8EMWBCykqOOOraOw8pqxPBlfIwyC3tUYgYIIr1pu1ffkdHdTU6QEmjj6yUQEGKPWTErm08uXSAfM2xRucjFfqK83bK0hrxI7Hjhg1DTiVJAcY8eRkKW2fpX5sSECxBDoBwjgYcfD9xBffNPUOLmga8EtgIU4Z6kLz3sMrph+3kj7X5Qt8J3SCGHeGlFUIRI+fE3pdbT4pH30gCI908aXvw1209n7At6Xl9Tb5k+Na0GvQ2JJk/bCjgeF/eaPtUy0mdSWD7AwzbAL2bayCrUqHfXbM2ZuvcvghnoOB3k3l2+wfDgGTFqaAYQzcYmtM1CutITKDdgJar9hP411oEDe1xZS/D6Z6a3rgxhCF7bMaU2O+A6rxl6h6VhkhemzjoCi6+r315x6vvgNjxU5zryA1T+Ui9EeBeBMhKCGEkBkygNJw==; 5:DMr+CeoFe1WfQegj2Vbi1OOzbwmq9jJaeimkxL/7kx9iekNQNpIQlR0NpnpQaiXDSx1zZ17bpYfzFdhbiuDBY0B4RbpuMcl/SEgmjyxmRZYd5BuiCnGFoR5C0zRaK8qXTGiHUKERbFFf+gQkjXZl9Q==; 24:4c+i5ILawd7y/9oUb8leXrzzKw7WiGolJHImsCpkMd7fMYOlMaeb74ibSnTmFBULhIYliq54i9IPDjkNnGMiUopgk/cncdTFNXezJzvGXyc= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM3PR07MB2284; 7:OLggZqjK0ksMWb8SA5bgpDk+SnCztrRw3av06mvdM4xgDDbu11mf5tvGxds5+uGNDqKRvdokz8kwA8BLooVS6RER7OeHhJSIzWkhlQwq5hKqxCa3XxjD8dFrnr4eZMSYq2mW7hTo1zPhYY2NFoRt8gA/ecEFS4l53/QMazue7B5n1cgyifCQZ7n5CQ+H0990cFh24+8ff3I02YgvK639qtaLOHehEP00tJQCRyy6eZl4YNGWtuImcng0UOJiHIGSYgcyPPxPwrzBjm8vqoixMPIuQe/pXNqkLplgs/5R6m/0kdSe7vUubEOaMcQL5ffx6GcL5nkGua1sssZsQ2qX+Q== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Apr 2017 18:58:50.3036 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM3PR07MB2284 Subject: [dpdk-dev] [PATCH v2 02/10] doc: refer PMD compile and test section from ark 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 --- doc/guides/nics/ark.rst | 75 +++++++++++++------------------------------------ 1 file changed, 20 insertions(+), 55 deletions(-) diff --git a/doc/guides/nics/ark.rst b/doc/guides/nics/ark.rst index 064ed11..a7c2590 100644 --- a/doc/guides/nics/ark.rst +++ b/doc/guides/nics/ark.rst @@ -239,58 +239,23 @@ application runs to completion, the ARK PMD can be detached from igb_uio if nece Usage Example ------------- -This section demonstrates how to launch **testpmd** with Atomic Rules ARK -devices managed by librte_pmd_ark. - -#. Load the kernel modules: - - .. code-block:: console - - modprobe uio - insmod ./x86_64-native-linuxapp-gcc/kmod/igb_uio.ko - - .. note:: - - The ARK PMD driver depends upon the igb_uio user space I/O kernel module - -#. Mount and request huge pages: - - .. code-block:: console - - mount -t hugetlbfs nodev /mnt/huge - echo 256 > /sys/devices/system/node/node0/hugepages/hugepages-2048kB/nr_hugepages - -#. Bind UIO driver to ARK device at 0000:01:00.0 (using dpdk-devbind.py): - - .. code-block:: console - - ./usertools/dpdk-devbind.py --bind=igb_uio 0000:01:00.0 - - .. note:: - - The last argument to dpdk-devbind.py is the 4-tuple that indentifies a specific PCIe - device. You can use lspci -d 1d6c: to indentify all Atomic Rules devices in the system, - and thus determine the correct 4-tuple argument to dpdk-devbind.py - -#. 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:01:00.0 on NUMA socket -1 - EAL: probe driver: 1d6c:100e rte_ark_pmd - EAL: PCI memory mapped at 0x7f9b6c400000 - PMD: eth_ark_dev_init(): Initializing 0:2:0.1 - ARKP PMD CommitID: 378f3a67 - Configuring Port 0 (socket 0) - Port 0: DC:3C:F6:00:00:01 - Checking link statuses... - Port 0 Link Up - speed 100000 Mbps - full-duplex - Done - testpmd> +Follow instructions available in the document +:ref:`compiling and testing a PMD for a NIC ` to launch +**testpmd** with Atomic Rules ARK devices managed by librte_pmd_ark. + +Example output: + +.. code-block:: console + + [...] + EAL: PCI device 0000:01:00.0 on NUMA socket -1 + EAL: probe driver: 1d6c:100e rte_ark_pmd + EAL: PCI memory mapped at 0x7f9b6c400000 + PMD: eth_ark_dev_init(): Initializing 0:2:0.1 + ARKP PMD CommitID: 378f3a67 + Configuring Port 0 (socket 0) + Port 0: DC:3C:F6:00:00:01 + Checking link statuses... + Port 0 Link Up - speed 100000 Mbps - full-duplex + Done + testpmd>