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 0F97FA0C46; Tue, 14 Sep 2021 09:58:43 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id E6DF74068F; Tue, 14 Sep 2021 09:58:42 +0200 (CEST) Received: from mga18.intel.com (mga18.intel.com [134.134.136.126]) by mails.dpdk.org (Postfix) with ESMTP id 0C48F4003C for ; Tue, 14 Sep 2021 09:58:40 +0200 (CEST) X-IronPort-AV: E=McAfee;i="6200,9189,10106"; a="209013254" X-IronPort-AV: E=Sophos;i="5.85,292,1624345200"; d="scan'208";a="209013254" Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga106.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 14 Sep 2021 00:58:40 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.85,292,1624345200"; d="scan'208";a="451931303" Received: from fmsmsx606.amr.corp.intel.com ([10.18.126.86]) by orsmga002.jf.intel.com with ESMTP; 14 Sep 2021 00:58:38 -0700 Received: from fmsmsx612.amr.corp.intel.com (10.18.126.92) 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 00:58:38 -0700 Received: from fmsmsx606.amr.corp.intel.com (10.18.126.86) by fmsmsx612.amr.corp.intel.com (10.18.126.92) 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 00:58:38 -0700 Received: from fmsedg601.ED.cps.intel.com (10.1.192.135) 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 00:58:38 -0700 Received: from NAM12-MW2-obe.outbound.protection.outlook.com (104.47.66.45) by edgegateway.intel.com (192.55.55.70) 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 00:58:37 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ewAIAbEMY4XDNb6v0Hv2L9J+1XlhHjrZxF+CBnwc57qYAsJgQ0KotZ3ALUgk0fXLddRomWvncqUoBDUigwzOWctv/nKryqh4V0L26p2FnHz23kZ1tyuTBjLRS6kPRKqRAN7IlZcpoixodm2mNbxrmS9fyAFsUVBTU+bhOEeY3lMfzhZrLa0mg3ZSPI7c3MV1q5TUM6jVxmCWapAL3+Jh0pEWWcJ8v6v6uqT+ZYIqeQcpQNSSny1oTvqf/V1xMox61NAhGTFgPYkq/SpvdgqKLkMHXIJILy6zH+AzCwXmHA9DhQhyaFWXQV1KucvE68hz63InoZCEiu72xWoed54oag== 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=O2vgCXSVfAFU59G1xdSNNLkOEMP8cLTIpc6YudHnKmE=; b=TnbYJG+S8KF9CgA6bI5FTnE8qVGoozDMmKMzoxg65r4RJbJG5CcRzk2wpmbeTIvsMl785T81sf29bOt+KQqZj9+tYHvvhQahDpi+UcnRc9b6UAHdiahSQWuaGc7lk2I38jrBdzCCrQBFAUx9sORnz5HhQe57UAzpQN9QtxbqjGWF7SlKdiy3S5WeX7BDJomMoq9fp8bmgZDtPIEvUUXwDTCoA5AZspd3SJWNTIyWfhpIUNOvJNrBbXa37xZd/U0VZ+FU12/Qkq00S8t+1/B2mMYkGPDxAG4DiNAg1Lx011SHYkWAZ7uaZ0i2BFm+DoZSG06X5VmCDGUsLfOLok5LSg== 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=O2vgCXSVfAFU59G1xdSNNLkOEMP8cLTIpc6YudHnKmE=; b=xDNRI18sRIQQhfE5Ssvr+MI7Wfvp33lmt9zGLxHQsx/eo2/E73kM319Mko2jV2+RBUhpCL+lJGLlvTp49+3HbKbVrTDwd/SP+V7WJ/GcNuMC45AX+qjAiW52/5+mFSS5hcG9n0ot1mn3SPTMKTZsUr/7PUOymAxZrRv8L9xqvE8= Authentication-Results: intel.com; dkim=none (message not signed) header.d=none;intel.com; dmarc=none action=none header.from=intel.com; Received: from PH0PR11MB5000.namprd11.prod.outlook.com (2603:10b6:510:41::19) by PH0PR11MB5190.namprd11.prod.outlook.com (2603:10b6:510:3c::24) 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 07:58:37 +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 07:58:37 +0000 To: Ben Pfaff , References: <20210910175733.1248739-1-blp@ovn.org> From: Ferruh Yigit CC: Xiaoyun Li X-User: ferruhy Message-ID: Date: Tue, 14 Sep 2021 08:58:31 +0100 In-Reply-To: <20210910175733.1248739-1-blp@ovn.org> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit X-ClientProxiedBy: DB6PR0601CA0015.eurprd06.prod.outlook.com (2603:10a6:4:7b::25) 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 DB6PR0601CA0015.eurprd06.prod.outlook.com (2603:10a6:4:7b::25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4500.15 via Frontend Transport; Tue, 14 Sep 2021 07:58:36 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: fd9154d7-0da7-43ce-6021-08d977557523 X-MS-TrafficTypeDiagnostic: PH0PR11MB5190: X-MS-Exchange-Transport-Forked: True 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: 17DmSlomLOuWjNUnnqWWddiukhx+IaUt0FQoXpzX91UEYvxGgG+UeP2JxDKnbIYCeRRvXca+UZR8M6IW6SKz/2XcdHfy83PWMZu88ew4CNUpxSWyvenIoO4hy5jxNysBQziv/h/ZdUBdKDyoPdNL5d0E3T48lweWfamveZLbd+C37kxfqBjbQtR9hTRKJebIm6i7zEyl51ZnwHdq2NHxFj4HrraMdje/ezPoipF/XRk40ZBPTq45AyElzhHxdquiLNBZPlJAFpt6nYZojJJ9GtPQLS/cb6xtWuOQX0b5B45tB2HVx6fq76Okj46RDFcjigL7X3S/eCCvgwJcLK2wcRFsIddiUHyU7RY552PPIwAaUIin8l80yxowCxsoRPDR3uhXlWiBnhh3kgq/0hPoSadFwLc7/Vrl+j2HcmuN0cMeqZrg2bLeBG+ghkvGf+fx1Z6nr8jjBrFMeuBDif2tU98S08bAiqiDEGe0pnB0waZsAMVOPNkaUCjOP4VBi63Qf/v/Lr4WpfPtXTeRsBQPDlPA5TuofwXCdQ4PR89LVtlLOaVa6ts1vsUG+tUUpt2rsEfSt1/x3RAYFElaKMVh9pF/9DshEgxLKtoEwvyFgd/IwNjmhHSmaYpe95uSpmggIESsFxZ8BwyqCbFzTpysDWf2uXTZv2ztB1Ll1zSY1+8ohkmYfbQMyfutxInjaouyiTc324oELHtWPzEC6/KCdw== 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)(376002)(396003)(39860400002)(346002)(6486002)(956004)(478600001)(8936002)(26005)(53546011)(16576012)(2616005)(6666004)(186003)(31686004)(316002)(66476007)(38100700002)(5660300002)(86362001)(66556008)(66946007)(44832011)(4326008)(36756003)(107886003)(2906002)(31696002)(8676002)(45980500001); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?OFA4b1lyenhFNktnMTZkbmRpTHI5QVJCa2dxOWFEWk5kbjJ1aVFEVUZyQUpY?= =?utf-8?B?UXQ0eEU3OE9LRDhCK0F0RDMwbldmd2FkNFp0RTdxTWVTSWdXaFZIZU01OFJZ?= =?utf-8?B?RXM5UjZuY0pWWHZUVTE1Ymgrd0NpZGVIaE1XOUdRNWlMR2tYR1BFWTRyYmo4?= =?utf-8?B?aEE0cGIrRXJtVkc2c1ZqZ3VrL051bmFDbnlYN1lWcUt2MzRZWHdXNitIWDJr?= =?utf-8?B?b1B5RWM0ZUpNM293eWlLYm9JNERSY3dXcTlLVWNvek03aXFuU3VPNEdJMWxD?= =?utf-8?B?SVJ6TzErMndSY2xicUdaSm8wRGhaYUZ6T0hIL3J3SGk5RGw4d0t0M3VGcFlq?= =?utf-8?B?cDMyWGI4Y2tUZVU5R0s1ZkZKcUpQNWljdHQ2Zm90YjdSTEZ2UXBnU1p6U2Ex?= =?utf-8?B?ZlRIUmdEWHo4L1ZwR2hEQlZURzZqd1U1UlB5eVJOaXpNeTRTWHQzMXFXaWdE?= =?utf-8?B?alZxR2ZKbEpGbUU5ZmFUSkpTTHA1cERlL3NrNUJYbjF4L1lRSWswWmRnTE9I?= =?utf-8?B?SmE0M2RPUVJkL0xrNG9URUFCOTl0YVhuUTA2UHZGd2NPblIrWGhxM0tEdkNO?= =?utf-8?B?WHkwbUtpTGRPV2NRUU5pb2kweFoxOFAyTGlKS1puZFo2WEZyUWprVlh0bGlS?= =?utf-8?B?VXUvZ0cwVVdPUW8weWsvcURZNHF1NHhZRE9NL0pHQ2dBZVIxY1lZZ2lYZDBy?= =?utf-8?B?TUxZYnlYWEN5YTllUVZFYUU4S2dyVjVKb2NCTlg3T3NUY0UvRlRxV2d3MmFo?= =?utf-8?B?QVlTVjU0UUJySE1tOWpoYUtKQng4alh4Ry9JcmtWOFZBK3M0WTBDWi9PemFN?= =?utf-8?B?Z0pKUU5MYzdWNHpKZmdWaFhLcVNxR2FKbndSOWRSaXVTb3A0ejNxbzhrcDJq?= =?utf-8?B?eEpuQ0E2SzdOVVovQmYybkZzUXJRYXY3bTdoNXh3RkRVZG4xNkJGU3d1bmEv?= =?utf-8?B?RWNNSXJJdGJMcUZMNXJzYkh5MzFtQVdyY3hBcTNrdi9ubmVHdmJkVjdSVVV1?= =?utf-8?B?c1ZLNmg3UjRaeHh1enVIU0Rmclg0c3hMQjJRcUhhc00wRTJKT09kT1BHemNq?= =?utf-8?B?SG9qWmZ6K2djRm5mbThHTUlpa0FnbTlHUHVaeHhVcmVBcXVvZ1ZLdTlFb094?= =?utf-8?B?VkQvQS9PNm5WZFlPYXF4d3VySXFXdTBwTUZ2YWxjK0hidnVuN0tVbGJUSTFD?= =?utf-8?B?VWtXK2tlb3JzSTMyL3hLQWUwWEIvMGgrTWRLVjYydXQ2WWsxbXU5VzBLaXFj?= =?utf-8?B?MnZ6V2s4OG8yN3l2Z3JqUzFhYysyKzhYOEs5dGIzTzNYclFLYS9zUDE2SmN4?= =?utf-8?B?TlhwdnBvN0xNcm1WNnFtZnJvYkNLMjVUOXpjZ1VJaUtlTlNxYXV1ZUV1ZUNx?= =?utf-8?B?MUZZaTA4OHhlZFlmOTM2NWszRWErbkFkOVVDNnVJUG9HenRBcHRyUnNrUXlX?= =?utf-8?B?NnAzNHYyakxLQTBHT2RQZ3FKMDBkazY2ek42d2wrNjNvbHBDNVcxdVNtbCtH?= =?utf-8?B?WFk1R2FwWXpKTnBpQ08xSW4wSFVNL2l1eTQ3bndnbnRkU0RCSXg2UHZWR0RS?= =?utf-8?B?N3dUUWJsUEhYbzk1RUV3VStiamp1bWhDVkhTSmVwREVoUGU3VnAxSFBZUUJk?= =?utf-8?B?SUYwWVRqSzgxclBGaWhVd3MyYm0wR25uelZtbkpLNllxM2RHM0MvR0hyTVg4?= =?utf-8?B?YXhTVm4vU2V4VkM0b1c2VjVZVGZvbW9VVDhwUnR4SzJaSWpyR1VNU0FqN0x4?= =?utf-8?Q?piKxShQ9qpWorhKEp+K4jRYbpIx4koEBvxClKj8?= X-MS-Exchange-CrossTenant-Network-Message-Id: fd9154d7-0da7-43ce-6021-08d977557523 X-MS-Exchange-CrossTenant-AuthSource: PH0PR11MB5000.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Sep 2021 07:58:37.2964 (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: +CxO7Ssth/759I+iyNgE7J4CL27KjFv6iqTtZhFJdU2GNdjfKhPFV3Z5yDbfDWrKcO4GuBCzEVqARCgBvZ7eUQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR11MB5190 X-OriginatorOrg: intel.com Subject: Re: [dpdk-dev] [PATCH] 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/10/2021 6:57 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 > --- > doc/guides/testpmd_app_ug/run_app.rst | 6 ++++++ > 1 file changed, 6 insertions(+) > > diff --git a/doc/guides/testpmd_app_ug/run_app.rst b/doc/guides/testpmd_app_ug/run_app.rst > index 6061674239..7c3406f72b 100644 > --- a/doc/guides/testpmd_app_ug/run_app.rst > +++ b/doc/guides/testpmd_app_ug/run_app.rst > @@ -15,6 +15,12 @@ a list of available EAL command-line options. > Testpmd Command-line Options > ---------------------------- > > +By default, testpmd receives packets on each configured port and > +forwards the received packets to its paired port. Ports 0 and 1 are > +paired, as are ports 2 and 3, and so on. With an odd number of ports, > +the last port is paired with itself: packets received on the port are > +sent back out on the same port. Hi Ben, testpmd has the concept of 'forwarding engine' (struct fwd_engine), which is decoupled from testpmd logic and can be changed in the runtime. What you described above is the 'io' (default) forwarding engine. There are forwarding engines like 'flowgen' that generates and send L3 packets, so behaves like a very simple packet generator, etc... And even for the 'io' forwarding engine, the paired port description above is controlled by "--port-topology=", so for example if the 'chained' topology is selected, packets will be forwarded as 0 -> 1 -> 2 -> 3 .. Overall, I understand the intention to briefly describe the testpmd, but I think it is not correct to reduce the description to packet forwarding, although that is an important function of testpmd, it is not only function and testpmd does much more, it has many control path functions. Cheers, ferruh > + > The following are the command-line options for the testpmd applications. > They must be separated from the EAL options, shown in the previous section, with a ``--`` separator: > >