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 8115145BB4; Wed, 23 Oct 2024 19:35:12 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 7301B42EE0; Wed, 23 Oct 2024 19:35:12 +0200 (CEST) Received: from egress-ip42a.ess.de.barracuda.com (egress-ip42a.ess.de.barracuda.com [18.185.115.201]) by mails.dpdk.org (Postfix) with ESMTP id DD65A42EDE for ; Wed, 23 Oct 2024 19:35:09 +0200 (CEST) Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05lp2169.outbound.protection.outlook.com [104.47.17.169]) by mx-outbound42-14.eu-central-1c.ess.aws.cudaops.com (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Wed, 23 Oct 2024 17:35:09 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=b5/RGfld8lJkWs9KxuNdqyTrKPthtQPGDF70OPsuUMHZmgg6fpVD9oQtmin+fk9WIUFTvrnghuwEWVaZiZGUUG+W8fWjZsSsanfDV7euxs2zuX6mB9st+79J33TxEJLB3SKnvImPILOB71b4YPkLjnrM1H2BdCcG+3MtpTQFof+esOzRNZmgEcKKeX/iuNRr7xdWE9nG1sJKtD845e1kWrzPdvlPN/TpEzLcM0DcVCl3sF1En+yZyHBYXQIEIR7pOidoixmXUUd2OqTz5Adq7O4M1iN9xpyu2fKggt2J5RVsYXcYfbwoj6fWI5y6VKp69WZOJLIDisNMMXcRjFDYHQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=Jd5AALSOPZkiDYNgUr9eK1VN8Lx8omXH/+58KyQVpH0=; b=Xag8rLbATI5JBiaGjeuWWg18/6LSh7TBqq5jkblDyloIXjJ0bvsWCAFA1LP/GlUBkyhotp8V+Hs6g8EYCkhOfdTcggKiUPaa7x8hrkpDyq0LhSfoMZQh8gHUzXpRBAwvELjES2tJ+awP5HzUBzc4knqdEgk/AP0VrcOL4GaKXWXTpfGUEOgV5KxJca1OJv8Ud9f4AVeyWJL1vgOPqCIvD2oWrbC+SNKdGEHnsOQJ56qzBd3H4/1J2uHZytS84j5u9/R4gSu4AaRiG1oP3qk+mAsL4XXnMindABMx6TG4RFfzVyPr1dLeGV9VtOL2++oEkRmrb+/5XIlKKmv8eom8EQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=fail (sender ip is 178.72.21.4) smtp.rcpttodomain=dpdk.org smtp.mailfrom=napatech.com; dmarc=fail (p=reject sp=reject pct=100) action=oreject header.from=napatech.com; dkim=none (message not signed); arc=none (0) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=napatech.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Jd5AALSOPZkiDYNgUr9eK1VN8Lx8omXH/+58KyQVpH0=; b=fq0YgAC0RkHsONhLUHQRpe9EK4MjUZJIA2YQ/HU9eIMdEnJ6Lj9bjavIQGPhDTNV1PIkLZzGHwgTBt/WhVwjlqaxTVc0bSutE5zguuSztiDpEKnK8gpuU15I/fdcT09rr0Gd9ffYv7QF9nnfutVsVLb+RcVfd0zy1qdU/Vs44lI= Received: from DU7PR01CA0001.eurprd01.prod.exchangelabs.com (2603:10a6:10:50f::16) by DB9P190MB1722.EURP190.PROD.OUTLOOK.COM (2603:10a6:10:330::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8069.28; Wed, 23 Oct 2024 17:01:47 +0000 Received: from DB5PEPF00014B9E.eurprd02.prod.outlook.com (2603:10a6:10:50f:cafe::a2) by DU7PR01CA0001.outlook.office365.com (2603:10a6:10:50f::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8093.17 via Frontend Transport; Wed, 23 Oct 2024 17:01:47 +0000 X-MS-Exchange-Authentication-Results: spf=fail (sender IP is 178.72.21.4) smtp.mailfrom=napatech.com; dkim=none (message not signed) header.d=none;dmarc=fail action=oreject header.from=napatech.com; Received-SPF: Fail (protection.outlook.com: domain of napatech.com does not designate 178.72.21.4 as permitted sender) receiver=protection.outlook.com; client-ip=178.72.21.4; helo=localhost.localdomain; Received: from localhost.localdomain (178.72.21.4) by DB5PEPF00014B9E.mail.protection.outlook.com (10.167.8.171) with Microsoft SMTP Server id 15.20.8093.14 via Frontend Transport; Wed, 23 Oct 2024 17:01:46 +0000 From: Serhii Iliushyk To: dev@dpdk.org Cc: mko-plv@napatech.com, sil-plv@napatech.com, ckm@napatech.com, andrew.rybchenko@oktetlabs.ru, ferruh.yigit@amd.com, Danylo Vodopianov Subject: [PATCH v3 70/73] net/ntnic: add aging documentation Date: Wed, 23 Oct 2024 19:00:18 +0200 Message-ID: <20241023170032.314155-71-sil-plv@napatech.com> X-Mailer: git-send-email 2.45.0 In-Reply-To: <20241023170032.314155-1-sil-plv@napatech.com> References: <20241021210527.2075431-1-sil-plv@napatech.com> <20241023170032.314155-1-sil-plv@napatech.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DB5PEPF00014B9E:EE_|DB9P190MB1722:EE_ Content-Type: text/plain X-MS-Office365-Filtering-Correlation-Id: 77775250-7446-491d-ec98-08dcf384612c X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; ARA:13230040|1800799024|82310400026|36860700013|376014; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?8oX/6RXxOK/VtQ6qlZjZk6SaE3CWXarQqZcItrJ+0AL435B3gGZkws94bP95?= =?us-ascii?Q?elXwEHlv6vZB0c/cENxf5S1XuCjHg7EkAqVI0+EaisBGSeXprI7yBDsdYZ4l?= =?us-ascii?Q?8tkouwCsZ4MNinOIOBvnovi2x533q4OtVGllIFQyzidBkZde1dfwvTOCHo42?= =?us-ascii?Q?LOXa/645KVYOFP9jnyGl0XahebkohqwISfd7B5UXdD6nPdFu3vdtUYRIkdbG?= =?us-ascii?Q?HzvVq+J+j5rD2sCwkzj8y0N1LmjF4qVF5sRdEC53tHnm7rc9QOudKj6shfSy?= =?us-ascii?Q?3zvXvza207ZtRrbQwJaUDQvVl/Pz8Y/OgjbRdzh0KUHBnu8W9HMdr0zoxh9h?= =?us-ascii?Q?KJNXldoKXLhUERJ8cNJZUe3q8TcFLu3Quyfh/MTBq8rhnOsGrbahOvz/EBKW?= =?us-ascii?Q?FC0ID7P5zIFMpPLXOtlw1Kc1ZS0z/ATu5D9yHNCLc3Uz1yYGeumnxBorfhE/?= =?us-ascii?Q?bOBo6XEJ0p6MQYFrRugaZkxeLvfyawQTf+h1X4zPX5Khd5PNzQ8xaHlIR1yc?= =?us-ascii?Q?b4eXgxwcZGmCCaUbY89CDgVAxPKPElbgJZRczinXFiK0QS5k71qIw1+F7lbm?= =?us-ascii?Q?siwMFSmO8VGNOvkMK6IVIoqbP9WHNXau4xdyNOyjLe59/og2krlI1ZrxjFuA?= =?us-ascii?Q?Lb6flLl1OxgNvu5aL/scIr2IK0c3aow6/UjUp1QcFxciabEiarephA2LXtVd?= =?us-ascii?Q?5KcoNOzJ2HCON0mn5+qMZ+nvoHss0MFLWtzTodiLPmomCwOuaf0sf8tIygek?= =?us-ascii?Q?up0dgwjzQdPLP09ZI0z6Q5v7AWzl0XCIECrZWeJmugwjdXSup67gLg0GELj3?= =?us-ascii?Q?cLmg/u0aUaZO+nfrjxDEy22DcXnYIELYWkb+BOpflagugUKik2jtWDzpfiun?= =?us-ascii?Q?Rwhca9vCryus1t766FGVEj6DOFKTc57X9SuPEXmioJJEonmov78ok9v1BH8D?= =?us-ascii?Q?lk8L8ei82OEJ4xxgMi3a/Fd7vwOsUABb0oDvafgPMZhKXJjlHPxLtHfawq7C?= =?us-ascii?Q?hqVmtVorsO/Y77wvf7/0C0utv2vbytZEJbz72LTm8SO2ISFVtN4x80+VHgBh?= =?us-ascii?Q?9wFlmEj58kB8QpllYsnUNl/xkWbUdJ7i7oH1UrX7VszjiCpr++x4tbWChY9Z?= =?us-ascii?Q?SifkZGRpH+81ojAuLoug9O34NZ4PlcY87bjUUuRKXZFJ3Kn2aINAs/rURU6T?= =?us-ascii?Q?8kgKJOs6dOcCp5YO6UbiGQyqckQrFiLsvGN6LK3/DbHrefEuVVsNDTi6MnQ3?= =?us-ascii?Q?cFIcpQ3rVtlaFTNckWc+3+iVGWBErfo+ftKrn3S6BFAfVPErKm68tUldZfR4?= =?us-ascii?Q?7p95lSTWlMw+kshnexvuKzHag1n6StF7xWcXvzUS+83B5XAw3XJHK/va/ls3?= =?us-ascii?Q?J+bLZ8d6fOirHf7k91OxUPPZqEq/08RIJWBTvGxz6nk4BWOiHg=3D=3D?= X-Forefront-Antispam-Report: CIP:178.72.21.4; CTRY:DK; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:localhost.localdomain; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230040)(1800799024)(82310400026)(36860700013)(376014); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: CDCYkAwX9PMO0pfqIRX+Aet6UiFKAVZs6wNGO7GTnrWNxI8s3KHvY727fRmMHC5vfIhtS2eXd28ZooXyhFTnuV0/9Mm5s39bUwX4pqkIDA0NNCy09Z76COboXDG42SviN8zp4OF0KfiSX4kSsK9wwIkdhbwPs5ULMIJUGL6OagxYF7bRpa+bD81/SUJOnhJkazrF69zzdntTKzbB/wy0es3AlbE0RAhBsqxb64CGqs/1h1bB3NNuv7Rt6TPue4cQSpiSw4kqWK4sqxMhfpgbWKoCMn9nJrB8ZC9AE1isY9JjbznK4fJZHDKyOZopZ05zW+aulowonQxVDDuRKEwZunGm4hgjfVY9qLNS92PBcyd3dgDY4XwrEcoD0/p77mFTvqKHrsa4pscQOnlTwVFP58RVNWqIHFkyJRJGpehCPbv2w99CXt+B746e6D5lv/MyP6uXoPJEQJoglR44nIPm2/jTad1nlFj5Hm3mvQFNhfZP5z6TZjpiC6qlWyskOCGEeLVXgNOZ0lAmdaotySASeUhml50/dVKwDtWBbwk4CnioBZBjwaLZunr2d9RLYC386z7HwByIAjCHUNI4kSeOJSi46XEl0dS5BgOCpts19y45gS9ALNhZjLOfJbNBOUCh6ZpuC1GYftm3Jj40zuE0GvS3/OCg/+2e/+zaaNrqN1k= X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Oct 2024 17:01:46.8522 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 77775250-7446-491d-ec98-08dcf384612c X-MS-Exchange-CrossTenant-Id: c4540d0b-728a-4233-9da5-9ea30c7ec3ed X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=c4540d0b-728a-4233-9da5-9ea30c7ec3ed; Ip=[178.72.21.4]; Helo=[localhost.localdomain] X-MS-Exchange-CrossTenant-AuthSource: DB5PEPF00014B9E.eurprd02.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB9P190MB1722 X-OriginatorOrg: napatech.com X-BESS-ID: 1729704909-310766-20172-22362-1 X-BESS-VER: 2019.1_20241018.1852 X-BESS-Apparent-Source-IP: 104.47.17.169 X-BESS-Parts: H4sIAAAAAAACA4uuVkqtKFGyUioBkjpK+cVKVsYGBsZAVgZQ0DjJMtnQIiUx2d TQ0iDZzNIyLSk12SAtLTHZ0sTYxDBFqTYWAOzXTPhBAAAA X-BESS-Outbound-Spam-Score: 0.00 X-BESS-Outbound-Spam-Report: Code version 3.2, rules version 3.2.2.259925 [from cloudscan13-54.eu-central-1a.ess.aws.cudaops.com] Rule breakdown below pts rule name description ---- ---------------------- -------------------------------- 0.00 BSF_BESS_OUTBOUND META: BESS Outbound X-BESS-Outbound-Spam-Status: SCORE=0.00 using account:ESS113687 scores of KILL_LEVEL=7.0 tests=BSF_BESS_OUTBOUND X-BESS-BRTS-Status: 1 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 From: Danylo Vodopianov ntnic.rst document was exntede with age feature specification. ntnic.ini was extended with rte_flow action age support. Signed-off-by: Danylo Vodopianov --- doc/guides/nics/features/ntnic.ini | 1 + doc/guides/nics/ntnic.rst | 18 ++++++++++++++++++ doc/guides/rel_notes/release_24_11.rst | 1 + 3 files changed, 20 insertions(+) diff --git a/doc/guides/nics/features/ntnic.ini b/doc/guides/nics/features/ntnic.ini index 947c7ba3a1..af2981ccf6 100644 --- a/doc/guides/nics/features/ntnic.ini +++ b/doc/guides/nics/features/ntnic.ini @@ -33,6 +33,7 @@ udp = Y vlan = Y [rte_flow actions] +age = Y drop = Y jump = Y mark = Y diff --git a/doc/guides/nics/ntnic.rst b/doc/guides/nics/ntnic.rst index e7e1cbcff7..e5a8d71892 100644 --- a/doc/guides/nics/ntnic.rst +++ b/doc/guides/nics/ntnic.rst @@ -148,3 +148,21 @@ FILTER To enable logging on all levels use wildcard in the following way:: --log-level=pmd.net.ntnic.*,8 + +Flow Scanner +------------ + +Flow Scanner is DPDK mechanism that constantly and periodically scans the RTE flow tables to check for aged-out flows. +When flow timeout is reached, i.e. no packets were matched by the flow within timeout period, +``RTE_ETH_EVENT_FLOW_AGED`` event is reported, and flow is marked as aged-out. + +Therefore, flow scanner functionality is closely connected to the RTE flows' ``age`` action. + +There are list of characteristics that ``age timeout`` action has: + - functions only in group > 0; + - flow timeout is specified in seconds; + - flow scanner checks flows age timeout once in 1-480 seconds, therefore, flows may not age-out immediately, depedning on how big are intervals of flow scanner mechanism checks; + - aging counters can display maximum of **n - 1** aged flows when aging counters are set to **n**; + - overall 15 different timeouts can be specified for the flows at the same time (note that this limit is combined for all actions, therefore, 15 different actions can be created at the same time, maximum limit of 15 can be reached only across different groups - when 5 flows with different timeouts are created per one group, otherwise the limit within one group is 14 distinct flows); + - after flow is aged-out it's not automatically deleted; + - aged-out flow can be updated with ``flow update`` command, and its aged-out status will be reverted; diff --git a/doc/guides/rel_notes/release_24_11.rst b/doc/guides/rel_notes/release_24_11.rst index 75769d1992..b449b01dc8 100644 --- a/doc/guides/rel_notes/release_24_11.rst +++ b/doc/guides/rel_notes/release_24_11.rst @@ -162,6 +162,7 @@ New Features * Added basic handling of the virtual queues. * Added flow handling API * Added statistics API + * Added age rte flow action support * **Added cryptodev queue pair reset support.** -- 2.45.0