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 B6BCC45BA3; Tue, 22 Oct 2024 19:31:03 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3BD0C40E13; Tue, 22 Oct 2024 19:30:37 +0200 (CEST) Received: from egress-ip11a.ess.de.barracuda.com (egress-ip11a.ess.de.barracuda.com [18.184.203.234]) by mails.dpdk.org (Postfix) with ESMTP id A575040B8D for ; Tue, 22 Oct 2024 19:30:34 +0200 (CEST) Received: from EUR03-DBA-obe.outbound.protection.outlook.com (mail-dbaeur03lp2170.outbound.protection.outlook.com [104.47.51.170]) by mx-outbound15-54.eu-central-1a.ess.aws.cudaops.com (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Tue, 22 Oct 2024 17:30:33 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=EZmDqsl9DLIcnKjqPSo4XSHElvyAmyJEt0k38RUtKcSqiv9E+tdObYVRusBIuiGJ1xYZIRNPrHMTjBANkmjAuQK2CoqSKtMc/pZ8knbf8UnLfvdNqzSP9PVHC2y0d++rA+hKMo30xd/Qh2NlzDZC/M56iAH0xTs6L2iinjoWUCaC8oq83l37BgN8lr7uvk8Qw9ioNlDknDFTJOV1OzfpteixZUDKJv2KkZVixhGDmxez2HW9MGycJa4GjxESF/MKf0oOlxH540BiRHetjKvIqyYdA67YLpsDYALFDmeqFPAHyxU8WpCl8Q9UmnTPJS4rcAECItP0Y0DPhpww4Xxu4A== 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=8kO+GRhkI6mtVrs/Mw/Rswj4aJ7szsqavPwJ29aojtA=; b=C0PZOPrqmM01iNr6p1PJresvkfmjny0QCQugAsSdYvMVco4+urBU5jlo00TNNpAHZZMqrAh2U/rLTpld8czuY1G0Sq1zYLhuzCyVFScMwMKThfZM9xPb1CDbksULREfIwxsV+icAyUgAlP3MB2j+sw0AMynmfXKD/73McQAsLDtrZ8wOu7NK2EAzmKVSOkrrhjG3hdiHicTEhcsGSiG5ktd/GS3sc+KS3ESGAxfBTivPRu0gbVsV4Eo7NxKuhaCaBysgFjKeMtvUmISRIxsZoucS8Odrgv8oI1xh56y8ta6xiATBPBIzRfXaKivK9bBHEEkmDOG5KHQhRuw4st4Xtg== 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=8kO+GRhkI6mtVrs/Mw/Rswj4aJ7szsqavPwJ29aojtA=; b=JA3RsGmzKinJHjO2H1KI+8OkUTtDi2mqg4OteVaDkFOtjjsUaWPPrZR/Yw+5BwSb+Ht98XkVsv43tzAU5CQcoIjNA5XylhdJLjfZiawxgj+W1G5oDRFaM5X/rq/SSVgqgA0AG0KPdgIq6ece6ERZHUjRJRIGNGkU6hO9KaeK7sA= Received: from DB9PR06CA0022.eurprd06.prod.outlook.com (2603:10a6:10:1db::27) by AM9P190MB1234.EURP190.PROD.OUTLOOK.COM (2603:10a6:20b:261::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8069.29; Tue, 22 Oct 2024 16:57:18 +0000 Received: from DU2PEPF0001E9C2.eurprd03.prod.outlook.com (2603:10a6:10:1db:cafe::ad) by DB9PR06CA0022.outlook.office365.com (2603:10a6:10:1db::27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8069.29 via Frontend Transport; Tue, 22 Oct 2024 16:57:18 +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 DU2PEPF0001E9C2.mail.protection.outlook.com (10.167.8.71) with Microsoft SMTP Server id 15.20.8093.14 via Frontend Transport; Tue, 22 Oct 2024 16:57:18 +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, stephen@networkplumber.org Subject: [PATCH v2 70/73] net/ntnic: add age documentation Date: Tue, 22 Oct 2024 18:55:27 +0200 Message-ID: <20241022165541.3186140-71-sil-plv@napatech.com> X-Mailer: git-send-email 2.45.0 In-Reply-To: <20241022165541.3186140-1-sil-plv@napatech.com> References: <20241021210527.2075431-1-sil-plv@napatech.com> <20241022165541.3186140-1-sil-plv@napatech.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DU2PEPF0001E9C2:EE_|AM9P190MB1234:EE_ Content-Type: text/plain X-MS-Office365-Filtering-Correlation-Id: 0ced5466-14d8-4bc8-81e4-08dcf2ba96cf X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; ARA:13230040|376014|82310400026|1800799024|36860700013; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?3kchWtzXJzgTQJ6xI79XFdARtZiFxMARgf6/JTdSiBdseVrg0rz/k3GBbSHt?= =?us-ascii?Q?Supihxa2z+LjW68uviyrDfVdY2GULQdKhgeJnb2gmOgL76QDHLSmu6WzpaYr?= =?us-ascii?Q?9MaWGyZ9T7xjEkhVHICs4iDGb7U8e8C/Swmquq8SgTWBi73zsm01CylobF8B?= =?us-ascii?Q?mtKJJCOMSl65uKQNAgVpLauJJ+ub0OjDTCXTjVZb0ZNYAyUhcKDZV7LrRyhK?= =?us-ascii?Q?Xp2/LyMi3eTK1KF24vwVtys8Fupa0r8MtBamki6vs1EbUQlNNCjPIRxcPWbf?= =?us-ascii?Q?W/lku8gtScRWS+QTZPExszmYrCChUw5uyIgmd05q/fDjWkxFXwj05Er3bBQY?= =?us-ascii?Q?4umLrUoNNa6cV1CCamYxadpVEsBfwFj9Jo1RHV7aRpJLrE/fRo+iIpECcGB4?= =?us-ascii?Q?VF2ueat19UeQNeMZ6st2geV3M2ZrrNPVsH7+670llaF9nD0q+lNY3oUY2ywM?= =?us-ascii?Q?wR45LmSIcGUCRS40Q6W1lCLXspiS58XOdcPdc2T73gSKhn1M1u+j31/rIvgb?= =?us-ascii?Q?IcYDkuEr7zF1UD/ajr4nMnb5KsflBYGCbQ8d2KnafbZi1ojG1Y6ElSJI/ozt?= =?us-ascii?Q?v9INjn6ZrKFeKXFvxLjTq4d5XlpSINMxT4ijIt1KMJA7dcGpJlU0ckSKKy4W?= =?us-ascii?Q?O1Vks07WkFAGF6mdArrs5X75X78mLCFxhOQsr9fHfOPkLaHg7fKFGajrWngO?= =?us-ascii?Q?oMi2vD9tHRKeTr97JcSYU0eXWH7SuevtdfQfsmCNwtfwUdbcvShqOXkTd1EH?= =?us-ascii?Q?6hpruhL0tydeGskbCXAjF4euf76XXlvDDz8eDv3MIXjfX/yqrSpQxuphPui6?= =?us-ascii?Q?Uh9yYEUp/NX7abx8dr21Bl1+9QBBcrY7lW7jCaV9ETTKxQCgPjeCequxq+Po?= =?us-ascii?Q?AttSwNrdc/PdGjTyHv9TDg87VVYukVcl+ANY33GQB2DMVpYLxqpalc1dnshV?= =?us-ascii?Q?wWgNRlxNB+rTVuiIjDvBKo9Tq6gms+w93SDLPUdK+Bof6KqH/F0Ya8PuM8KJ?= =?us-ascii?Q?Sif4F+/9reL+5czFC/aCal61h1PIgyIOD0HIfWM6HcPbT/paifrYBNjfTMfI?= =?us-ascii?Q?W8hwRZFLZFnDwlQ2F/NrcqWg4kCKWUAeym3pmITILNn8Leid23g11jua68xj?= =?us-ascii?Q?OSM+BgIySW+XTxzA0zJeT4o9gNDpwD8W+Uyf/2QyswFUQ8WPvJtkWvZOE4l3?= =?us-ascii?Q?BV0i4KaxWPte8NX1eLY/Qrd3u1ZjVduHlG6ziN+qQqTBmVTYiBvmS5O5vRhI?= =?us-ascii?Q?W3zXvg/VprHRNJiQPlk656ouQ0pIhROzea4KR6QCwFedxCGQeM2K7FK/DpPd?= =?us-ascii?Q?L5v1v+xqLN9bkJ90nwO4N+NtTk5Wn+Ik5kKOKK5l5Q5MhSIfp1PKkY0e55sZ?= =?us-ascii?Q?doicQ90j5rXdK2jcXCoLwUDUr2GbhFKG+WK8tRHI08wxdDrZ2A=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)(376014)(82310400026)(1800799024)(36860700013); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: mdAfPb7oDnJIJhhXYXqpitdUuQ+/p5cBvLwZa0kJrNUCAG2LOlmJvM0Y6eAPc4c/Q541L1NQhWgLOcaHKc5DNs8qasPfO8iFAvDyV2eOnYsSX84pU0B8+7pD1UEkR9B6k1uRWU1zhsSO6PvjkeptzFn6X5jXbBqq5J0hDyyVG1/t4uSXIkl+h95a0HplVAnCUx+JkPsi+4Pytud8GQyKZiKCtuTsLQ5/gkVrnv7OusVrcikAz4GhgFZFPU4P5rC8VoUD6pk9uEQ8sk2vca2cBjBR6Fije01JR4hIok4srmOg20/V/+rBYjTQWS/PUjZqLMC7ncp7Bth0mW/G4szj0LhhZOZHMXP3cRahkd2p8iTT+UCG0bclYTUxDWuh+nSl7wNHkdUuald5NDRLH0KEbO27h+dtHakBYGGNk7aFRyQ0oEDB4dt1uPx2nMwyUadY0ElaBzlrA/ctzjdEDPJwi6ZM8P88I4zscLhb3IVbfYGkUFFRJOevuVhPJ9oraVWJAFbX7iu8AezrSvpL6zH+4QLvEMMJT3MbJu7zt50+XTKcDV6h5bRXH+ITAcHpevOASnqiPMgIorB64U97KKDpVsPYsh7JN5mli+mMA3pCqBNvRq26coqSiJZKOEECV36ocez3YF5uHRMciBIxZ7Cb7g4Yuz5WvmLqwTmDKjIsfm8= X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Oct 2024 16:57:18.5131 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 0ced5466-14d8-4bc8-81e4-08dcf2ba96cf 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: DU2PEPF0001E9C2.eurprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM9P190MB1234 X-OriginatorOrg: napatech.com X-BESS-ID: 1729618233-303894-12661-14955-1 X-BESS-VER: 2019.1_20241018.1852 X-BESS-Apparent-Source-IP: 104.47.51.170 X-BESS-Parts: H4sIAAAAAAACA4uuVkqtKFGyUioBkjpK+cVKVsZmhqZAVgZQMNkiMdEsyTIpyS ApzdgoxdI4zdzEJNnIzMQ8zcws0ThJqTYWANYdcPFBAAAA X-BESS-Outbound-Spam-Score: 0.00 X-BESS-Outbound-Spam-Report: Code version 3.2, rules version 3.2.2.259902 [from cloudscan16-191.eu-central-1b.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 ntnic.rst document was exntede with age feature specification. ntnic.ini was extended with rte_flow action age support. Signed-off-by: Serhii Iliushyk --- doc/guides/nics/features/ntnic.ini | 1 + doc/guides/nics/ntnic.rst | 18 ++++++++++++++++++ doc/guides/rel_notes/release_24_11.rst | 15 +++++++++------ 3 files changed, 28 insertions(+), 6 deletions(-) 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 fa4822d928..5be9660287 100644 --- a/doc/guides/rel_notes/release_24_11.rst +++ b/doc/guides/rel_notes/release_24_11.rst @@ -154,12 +154,15 @@ New Features * **Updated Napatech ntnic net driver [EXPERIMENTAL].** - * Updated supported version of the FPGA to 9563.55.49. - * Extended and fixed logging. - * Added NT flow filter initialization. - * Added NT flow backend initialization. - * Added initialization of FPGA modules related to flow HW offload. - * Added basic handling of the virtual queues. + * Update supported version of the FPGA to 9563.55.49 + * Fix Coverity issues + * Fix issues related to release 24.07 + * Extended and fixed the implementation of the logging + * Added NT flow filter init API + * Added NT flow backend initialization API + * Added initialization of FPGA modules related to flow HW offload + * Added basic handling of the virtual queues + * Added age rte flow action support * **Added cryptodev queue pair reset support.** -- 2.45.0