From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id AF0FEA0C45; Mon, 13 Sep 2021 20:59:05 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 6890840151; Mon, 13 Sep 2021 20:59:05 +0200 (CEST) Received: from out1-smtp.messagingengine.com (out1-smtp.messagingengine.com [66.111.4.25]) by mails.dpdk.org (Postfix) with ESMTP id D8D6C4014F for ; Mon, 13 Sep 2021 20:59:03 +0200 (CEST) Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.nyi.internal (Postfix) with ESMTP id 4BA075C01E5; Mon, 13 Sep 2021 14:59:03 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute5.internal (MEProxy); Mon, 13 Sep 2021 14:59:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding:content-type; s=fm2; bh= UNJmgyHMjdknGhb77w9MkpgQdJrOu71kdQF7nuDtYXI=; b=kg8TLa/TlYq5jzst 32y7oScCJlarxWmMVwKqRMS/p6TH1Ov+DxHVcGx9msrhEeK9y7tSRqVY74vvuYUP 38n94XTdjbEONWwhUP7/DqZIv5jDGFxflV13qTpl3dWjXzJ9yuAZWoXUfbpi4v5g Mmg7EOqfLX0+al/ZZSFg4AURQ6EBoPriN5WpOjnDQl67XCAbnzpCECShSIK9+btw AOlEFaREmiku0qbYL6+nvI7oUUMfl/egSO5Of3TBG6YMsv+YgWa4eFSTk0bVPr4/ F9Ka8d2CrpDRobqsB+WUYq5L/XYW/AYEFOQoV7bomuhT3WBVzAlhgBDnyY2LPLJA h+qpQw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=UNJmgyHMjdknGhb77w9MkpgQdJrOu71kdQF7nuDtY XI=; b=XfRLg8nDMZ92/zXoq5spzJH71Ryx1TvMBEMA3igIk+Qp61YFtu+Ba9bJs iWFFams1J2fMZ0Rl7EDDyfhc6Eq+PHhHcwqF5DsC8tpc9YaIoB7hNqH4xF8mXQv1 7bSfJnPWUPf+l0m/iE6BlNVeUnyZEAOY/hiWCt/ZvayTBlNmIJX9HrcChUdj8+wB c7s6TNvGX4w6k490ywliZX3n3eoBXItsUTdEgK4Wxzl22fHs1XMy7OGCQpwDJmsn KZvVo3Izwee4pG1pG936IXd86Bq7I+3TJf48knhr3inoqbxxothpo/tbMMpIrzBg bqYNUZZc5Pqbn4GUcUB+pwLUQn6KA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrudegjedguddvkecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkfgjfhgggfgtsehtuf ertddttddvnecuhfhrohhmpefvhhhomhgrshcuofhonhhjrghlohhnuceothhhohhmrghs sehmohhnjhgrlhhonhdrnhgvtheqnecuggftrfgrthhtvghrnhepudeggfdvfeduffdtfe eglefghfeukefgfffhueejtdetuedtjeeuieeivdffgeehnecuvehluhhsthgvrhfuihii vgeptdenucfrrghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhhonh drnhgvth X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Mon, 13 Sep 2021 14:59:01 -0400 (EDT) From: Thomas Monjalon To: Ben Pfaff Cc: dev@dpdk.org, xiaoyun.li@intel.com, ferruh.yigit@intel.com, andrew.rybchenko@oktetlabs.ru, ajit.khaparde@broadcom.com, jerinj@marvell.com, orika@nvidia.com Date: Mon, 13 Sep 2021 20:58:59 +0200 Message-ID: <2339648.sHbIeL0nMs@thomas> In-Reply-To: <20210913183344.1513132-1-blp@ovn.org> References: <20210913183344.1513132-1-blp@ovn.org> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Subject: Re: [dpdk-dev] [PATCH v2] app/testpmd: Document what the application does. X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 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" 13/09/2021 20:33, Ben Pfaff: > I could not find anything in the documentation that says what > testpmd does. This should save other people time trying to > figure that out in the future. > > Signed-off-by: Ben Pfaff [...] > --- a/doc/guides/testpmd_app_ug/intro.rst > +++ b/doc/guides/testpmd_app_ug/intro.rst > @@ -6,9 +6,13 @@ Introduction > > This document is a user guide for the ``testpmd`` example application that is shipped as part of the Data Plane Development Kit. > > -The ``testpmd`` application can be used to test the DPDK in a packet forwarding mode > -and also to access NIC hardware features such as Flow Director. > -It also serves as a example of how to build a more fully-featured application using the DPDK SDK. > +``testpmd`` is a tool to test ethdev NIC features, including NIC > +hardware features such as Flow Director. It receives packets on each Not sure about keep mentioning Flow Director which is an Intel name for an internal feature used through rte_flow rules. What others think? Do we have better examples of hardware offload? > +configured port and forwards them. By default, packets received on > +port 0 are forwarded to port 1, and vice versa, and similarly for > +ports 2 and 3, ports 4 and 5, and so on. If an odd number of ports is > +configured, packets received on the last port are sent back out on the > +same port. > > The guide shows how to build and run the testpmd application and > how to configure the application from the command line and the run-time environment.