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 92CBAA0C46; Tue, 14 Sep 2021 10:08:40 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 0D1D14068F; Tue, 14 Sep 2021 10:08:40 +0200 (CEST) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by mails.dpdk.org (Postfix) with ESMTP id 3DAB34003C for ; Tue, 14 Sep 2021 10:08:38 +0200 (CEST) X-IronPort-AV: E=McAfee;i="6200,9189,10106"; a="218741841" X-IronPort-AV: E=Sophos;i="5.85,292,1624345200"; d="scan'208";a="218741841" Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 14 Sep 2021 01:08:37 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.85,292,1624345200"; d="scan'208";a="543846989" Received: from fmsmsx606.amr.corp.intel.com ([10.18.126.86]) by FMSMGA003.fm.intel.com with ESMTP; 14 Sep 2021 01:08:37 -0700 Received: from fmsmsx606.amr.corp.intel.com (10.18.126.86) by fmsmsx606.amr.corp.intel.com (10.18.126.86) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2242.12; Tue, 14 Sep 2021 01:08:36 -0700 Received: from fmsedg602.ED.cps.intel.com (10.1.192.136) by fmsmsx606.amr.corp.intel.com (10.18.126.86) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2242.12 via Frontend Transport; Tue, 14 Sep 2021 01:08:36 -0700 Received: from NAM10-BN7-obe.outbound.protection.outlook.com (104.47.70.104) by edgegateway.intel.com (192.55.55.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2242.12; Tue, 14 Sep 2021 01:08:36 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Pj9Qz3vf1HGN5X8ML+iDJ/69Wasa61ZFZfCqtgZxLo6y2eTMPdaDUne62rL5lHCytSlzMxvs08CRr5+Zx+gqCU3UJsoSR5eflbB6f9vT2nXK4OaB0GgvhXtLb14L2l7N0Ki0oAxZ7AqBZeDqacWapViv3VgMYCZFhnEQDeemeugzDFeuzTgiYxxgw5ikhfWWMHlPETvAUmAHyrGJPgczEa9vehG+6t0r/6Xz0bekFfCUMmR1IAIfUg0djEK3u9fIMo4cvtEVt5m2vvabma/1dt5dwWG9caysQP2VOLnOpAoqg8uUxwbtYUaeTzbfuUKzsYaxJOw1SppPl0tO0F4N+Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=nyy0nwQ1E8KicZVS9oBnLwEaeckxD5I1rdNKD+7lD4U=; b=Q795if8soNuE3Pre45d3kzNs6VRxYlRlw7iouOtl+nM/uoFyB4n4tGU38Tme9U4zVYVAlRnPwUn8YGhXkgB16NOEGjwVeze3j8/bbRCWLBL42BzZPMOyPC42nDUP3/TcAGbmiW0xOU3iaLgn0Q1W7dFPNeh4+2bJs7CwNRhJ3gAZzkyMfVrNnyNCNoMyR6tQtNxOPn1Xkql6Jxt2Kd5IJqTW5Sl7pE6C/qp1gfImz/LuEWQDP6AbLMb8ODGZcdP070lDUqi998VCb8JiaT8nacc3OeHlsexBdPVnNu3hSZ/gmIcKzwM5Qhe6NpHHcDntZqKkXcE9/pnR8emRdTdhAA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=intel.onmicrosoft.com; s=selector2-intel-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=nyy0nwQ1E8KicZVS9oBnLwEaeckxD5I1rdNKD+7lD4U=; b=qbx4ocWxfnD30RkfE2UFvKI2HsUtSElUcBIjyEaFbk3tI0yV0DxJ6Iebam0mGvyK3LBeGI30jFwGUSCZqGwGcwxuLeGskvJvFMXBGOQ6FJiT5sAGh6mRJUGS9lburLB2iEAi4aBd1IXXRX3A+SaU9uGVXQUpTPjhhr3UVOpyS5Y= Authentication-Results: monjalon.net; dkim=none (message not signed) header.d=none;monjalon.net; dmarc=none action=none header.from=intel.com; Received: from PH0PR11MB5000.namprd11.prod.outlook.com (2603:10b6:510:41::19) by PH0PR11MB5128.namprd11.prod.outlook.com (2603:10b6:510:39::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4500.16; Tue, 14 Sep 2021 08:08:33 +0000 Received: from PH0PR11MB5000.namprd11.prod.outlook.com ([fe80::747b:3a08:d1ec:31fc]) by PH0PR11MB5000.namprd11.prod.outlook.com ([fe80::747b:3a08:d1ec:31fc%5]) with mapi id 15.20.4500.019; Tue, 14 Sep 2021 08:08:33 +0000 To: Ben Pfaff , CC: Thomas Monjalon References: <20210913183344.1513132-1-blp@ovn.org> From: Ferruh Yigit X-User: ferruhy Message-ID: Date: Tue, 14 Sep 2021 09:08:28 +0100 In-Reply-To: <20210913183344.1513132-1-blp@ovn.org> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit X-ClientProxiedBy: DB6PR0802CA0040.eurprd08.prod.outlook.com (2603:10a6:4:a3::26) To PH0PR11MB5000.namprd11.prod.outlook.com (2603:10b6:510:41::19) MIME-Version: 1.0 Received: from [192.168.0.206] (37.228.236.146) by DB6PR0802CA0040.eurprd08.prod.outlook.com (2603:10a6:4:a3::26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4500.14 via Frontend Transport; Tue, 14 Sep 2021 08:08:32 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 4c0eb1ba-581f-4ffd-c6ab-08d97756d87c X-MS-TrafficTypeDiagnostic: PH0PR11MB5128: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:9508; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: G0K5fTHohqskTg9xz7/8LEUXFHGoB4PHYuKKI0IuGsM84LYe8gO+sIEyZvyl2E8ozXI1QCnFfzwrFe5kV8NpNLIfhN9GO/oS0UiCTxaTkgpUfPjtkLCS1Jz/JgxDtXkoLyENHJuCwlhHjutQBo61JLIwyPQamcst/DLsus1fTNT5JjLpW/myMbswEJw91oqW7Dt2DN/q+4ms4BG4F2RH2H3L/D9lv98zEPgcDmbdKPJz3vaVSytMiJ2ZeVLAR0MmcPYQqbWuHh6GKh3mHntcAIgQ0DigtUGRuA/f+s/KyYgKrBML3VjBhjXNREcNK/g3L2SMuz2UrgxWHqCzFTlCvZhZX2zm4MMB4DgA784hkWkr2nG6nGY12nVqWqX8DRXnFNzt9w+AglzVtUJBvGPUin35wuaPXJJaj+BX/2zX3BG6RpvqmlP13pKYHHs8PohPZ15CzTrOBchB5aGzdM27iMYSgOdI/sSzKZZdFKHtX6rB7FKKWWjhFSe5EB5rW3boFKedimlOupHMJYOyeQ0UiNtJMiWKUw0tdHT++FgDbd2+63Qv6Ctj/E/Or0ofiZkVuUAuufCxJGrq/ChjNdYJiNbJo4Wgova2AY6YU3+tPY3vVCn+moo2O2dBrmt9/8Mq513vdp+CYTHP/cL9aAp+SU5TsXUEveWPZ4zNLC6ia4pnatGaV5Z67qPksoVgub/12moZDb3LfiGDU/uhu5l155sKag5hDlGtiou9Q94ZOeKfM8jwn6UxnEWa24pbY6svZlvYuFLJXnlsHwbt58/C+AicEHvaWx1gfPAkJe7hp7k= X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:PH0PR11MB5000.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(366004)(136003)(39860400002)(346002)(396003)(376002)(86362001)(316002)(83380400001)(5660300002)(6486002)(478600001)(2616005)(16576012)(53546011)(966005)(26005)(36756003)(4326008)(38100700002)(186003)(2906002)(31696002)(6666004)(44832011)(66556008)(8676002)(66476007)(31686004)(8936002)(956004)(66946007)(45980500001); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?OGN3b2RTUzFqdUZSTGxzK2RjT29SKzVNRDhVVm5ndVdrd2t6aXRnQjhRSDJ2?= =?utf-8?B?MWZxdkxNSGxVc1hyVlU4d2M3aDcvdVNjOGlYTmpzNm54WEEyTDE4S0NBMDh2?= =?utf-8?B?a040SUdhYXJrb2VabkZvRzBsZUQwcU5EQ1RtVnNDanFseUF6NDFNemprQi9l?= =?utf-8?B?WEVKVTg2ams0NEJIUEZCdzJKalp4Q3hMbWpzR09ndjFWY093R1U0a1BDVkVS?= =?utf-8?B?STFZbWU2YVAxV0N3OXB4cFA0SWZvMHVTczJWZ2NNYjFsV1lhZWd3ZGRjSTBz?= =?utf-8?B?cUVuQjRpUVZxWi94QUdXUW1pMUVoWHAzZzBUcHYrOHluLzI4Mkc1TkVHVEk4?= =?utf-8?B?dlg2ZWVaaDF2NzFpZUx4UElUYkRtb093TzZVQ21hOVBncEtGRFFCc3UrU2k2?= =?utf-8?B?NHFCeUVZdGZudDlPbEQ4TlNVekkyWlFubkQyN0txZkQxcCtYeUNleTJldVVU?= =?utf-8?B?VUlBbnMycVNDOWQ0cU5kZVp4RVZ6QlJyRjlLb3NTOGVPTC9qMCsyKzQ0eE9s?= =?utf-8?B?TURqNXlYMWlSMTFzalNNM2V4Uk51WWozQ29tb2R6NnNjUk5PZDlwemtDYmVY?= =?utf-8?B?REd4Wk15S1NsSkVWRVAyeTU5dzlSRW9JUHpDbktJdEZFLzZWejhPM2Rwc3VC?= =?utf-8?B?ZUVNZ3RGQkwzTkM0M3J4NXBvcU5LK2thV29LL0ZmcDE0bFZZUHNOYkJRMStO?= =?utf-8?B?WTVhZVBMWEVDWWRkeGxNTGYyRWF2Wkp2OHVVMU03MVJzZlFjSXFxZEpnS2g4?= =?utf-8?B?UkRSRStNcmZlNTEzalVkWHMyanV6dWdHS0JaWHZDYlFua1hzenpoMW1xbENj?= =?utf-8?B?bXNwVUZoWGkxVFdjcWdwTVZHeDdNc09OQlJOZ2FKR20yYzJtWkE3cVJEZ1ZM?= =?utf-8?B?T05OOVgySTRTWFFYMHZkZXpaUXFBbG9GdmRMVzBlZHgwM2MzTmtMTXJiMlg1?= =?utf-8?B?b1ZoQk5BYjR6MHR6Q0dTblBQYnNQTmhnb0dRSUlkc2VBNWQzRVRNMzlQUGVx?= =?utf-8?B?NmFhVG80bXlLaEZoQUljUit0Z0hqWGVST2phVzdzTXhnWXk5dEN4eXdtQXBp?= =?utf-8?B?OEVDdVFZZHIxcG16YW8wQTNjV0RJVkd3WXVpV01WZ09adVppUk5LaW1LYW5k?= =?utf-8?B?eURURndFdWt1cDgrRzZ5bXBZNU5jSlEvTUNEckVLb3pUNXpTVmVVV1RUS3VC?= =?utf-8?B?S21hV2lYdXVXZFpESndOQUtXSE9XMkI5NjVHWnJMb3EwUDh4SHQzREVBNWR5?= =?utf-8?B?QWdGd0k4blF5WXJzV21Nd1hIWG9OMVM4YVhMNzRVR3loSkp3RzlFUURGM2Ja?= =?utf-8?B?VFpwQUlBUVgyZHV3UjF4MzhOYVV2QW4zb1orRkw2WVR3S0FFdHJGUStJc2xW?= =?utf-8?B?ZEhBazlEWUFra2dFT3VoVGJMa2hMQTU5TGlDZnhBQVFKbFNVdEVMaTZVUGNL?= =?utf-8?B?cXhBTUdnSDNTR1l0ZjBlRG9GaHJyU1RRQ3pWcmNENU53UHFMZDNsVE9CT215?= =?utf-8?B?emNvU2xqaTZ3OFhuR3FIRDFGbTlqM3RLb2o0T21UZm9OS09HMFRoSkI1Z0Rk?= =?utf-8?B?a1o3aUJVWVE5RVJ0VHNRTFJYWnRhbERYYTMvQTl2WkJMKzRNbURMWklFeGwx?= =?utf-8?B?MkJPTGZISEJVbmRaT0RoV3UvMFNaakR0TFRZWE11T0poZGh3UkM3STQ3R2dy?= =?utf-8?B?M282TnFaVjVuY1VPNVFaVUt0L0JtQzBzZEFrRUFkcFFKZ0NPblNtUXpTTGVI?= =?utf-8?Q?Vvs0Hdc3+2ZVCHUtWvMp/PmpkgQ8gdkgaSKndgx?= X-MS-Exchange-CrossTenant-Network-Message-Id: 4c0eb1ba-581f-4ffd-c6ab-08d97756d87c X-MS-Exchange-CrossTenant-AuthSource: PH0PR11MB5000.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Sep 2021 08:08:33.4536 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: dgthN/kgpqsJQCxQNP1+A6N2l73rsTzxkQ0wHi8L6UA3t512zmx7RCyM4oFCmq3KTe8FCxlkDhl68Kzcs+IA9w== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR11MB5128 X-OriginatorOrg: intel.com 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" On 9/13/2021 7:33 PM, Ben Pfaff wrote: > 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 > --- > v1->v2: Revise introduction instead of option documentation. > Thanks to Thomas Monjalon for advice. > > doc/guides/testpmd_app_ug/intro.rst | 10 +++++++--- > 1 file changed, 7 insertions(+), 3 deletions(-) > > diff --git a/doc/guides/testpmd_app_ug/intro.rst b/doc/guides/testpmd_app_ug/intro.rst > index 5d8d8cf4eb..1129f53c62 100644 > --- 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 > +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. > Ahh, I missed that there is a v2, I already commented on the first version. Just to summarize here, I think documenting a specific forwarding engine and specific configuration of it as what 'testpmd' does can be misleading. What about making it a little more generic and provide link for more details, like: https://doc.dpdk.org/guides/testpmd_app_ug/testpmd_funcs.html#set-fwd > 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. >