From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <Shijith.Thotton@cavium.com>
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 <dev@dpdk.org>; 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 <shijith.thotton@caviumnetworks.com>
To: Ferruh Yigit <ferruh.yigit@intel.com>,
 John McNamara <john.mcnamara@intel.com>,
 Rahul Lakkireddy <rahul.lakkireddy@chelsio.com>
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: <DM3PR07MB2284394A5626642584279E3081000@DM3PR07MB2284.namprd07.prod.outlook.com>
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 <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=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 <shijith.thotton@caviumnetworks.com>
Acked-by: John McNamara <john.mcnamara@intel.com>
---
 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 <DPDK-source-directory>
-   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 <DPDK-source-directory>
-   gmake config T=x86_64-native-bsdapp-clang install
+Refer to the document :ref:`compiling and testing a PMD for a NIC <pmd_build_and_test>`
+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 <DPDK-source-directory>
-
 #. 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 <pmd_build_and_test>`
+   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