From mboxrd@z Thu Jan 1 00:00:00 1970 From: Shijith Thotton Subject: Re: [RFC 1/2] doc: add doc with steps to build PMD and run testpmd Date: Mon, 3 Apr 2017 13:35:17 +0530 Message-ID: <20170403080504.GA20630@localhost.localdomain> References: <1491059040-20647-1-git-send-email-shijith.thotton@caviumnetworks.com> <1491059040-20647-2-git-send-email-shijith.thotton@caviumnetworks.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: "dev@dpdk.org" , "Yigit, Ferruh" To: "Mcnamara, John" Return-path: Received: from NAM02-SN1-obe.outbound.protection.outlook.com (mail-sn1nam02on0087.outbound.protection.outlook.com [104.47.36.87]) by dpdk.org (Postfix) with ESMTP id 308992C2F for ; Mon, 3 Apr 2017 10:05:36 +0200 (CEST) Content-Disposition: inline In-Reply-To: List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" On Sun, Apr 02, 2017 at 12:11:05PM +0000, Mcnamara, John wrote: > > > > -----Original Message----- > > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Shijith Thotton > > Sent: Saturday, April 1, 2017 4:04 PM > > To: dev@dpdk.org > > Cc: Yigit, Ferruh > > Subject: [dpdk-dev] [RFC 1/2] doc: add doc with steps to build PMD and run > > testpmd > > > > Add a new document with steps to build PMDs and launch a sample test > > application, "testpmd". It can be included in other PMD documentations or > > be referred. > > Good idea. Nice addition. Some minor comments below. > > > > > Suggested-by: Ferruh Yigit > > Signed-off-by: Shijith Thotton > > --- > > doc/guides/nics/build_and_run.inc | 110 > > I think that this should be an rst doc that is included in the index > file for the nics dir. It should be included right after the overview > in the index. > OK. Will add a section as mentioned below. > > > +.. _pmd_build_and_run: > > If this doc is included in the index then it needs a better first section > title. Something like "Compiling and testing a PMD for a NIC". > > Then it should have a short introduction like: > > This section demonstrates how to compile and run a Poll Mode Driver > (PMD) for the available Network Interface Cards in DPDK using TestPMD. > > TestPMD is one of the reference applications distributed with the > DPDK. Its main purpose is to forward packets between Ethernet > ports on a network interface and as such is the best way to test > a PMD. > > It would be good to add a link to the TestPMD into docs but it doesn't have a > target. We should probably add one (it maybe be possible to link to the RST > file but that syntax isn't generally preferred). > > > Testpmd user guide can have a label "_testpmd_ug" and can be referenced here. > > + > > +Driver Compilation > > +------------------ > > This and the next sections should then become second level headings > > > + > > +To compile PMD for Linux x86_64 gcc target, run the following "make" > > command: > > > s/PMD/a PMD/ > > Also add at the end of this line or after the command: > > This command will also automatically build testpmd. > OK. > > + > > +.. code-block:: console > > + > > + cd > > + make install T=x86_64-native-linuxapp-gcc > > + > > +FreeBSD targets should use "gmake" command instead of "make". > > + > > +For more information, refer :ref:`Getting Started Guide for Linux > > +` or :ref:`Getting Started Guide for FreeBSD ` > > depending on your platform. > > s/refer/refer to the/ > > > > +Running testpmd in Linux > > +------------------------ > > + > > > +This section demonstrates how to launch ``testpmd`` in Linux. > > s/launch/setup and run/ > > > > +#. Start ``testpmd`` with basic parameters: > > + > > + .. code-block:: console > > + > > + ./x86_64-native-linuxapp-gcc/app/testpmd -c 0xf -n 4 -- -i > > We recently changed the docs to use "-l" instead of "-c". Can you make > that change here as well. > Will use "-l". > > Thanks, > > John Thanks, Shijith