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 E5260456E2; Mon, 29 Jul 2024 13:47:27 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 6FD0F40261; Mon, 29 Jul 2024 13:47:27 +0200 (CEST) Received: from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com [67.231.156.173]) by mails.dpdk.org (Postfix) with ESMTP id 0BFC34021D for ; Mon, 29 Jul 2024 13:47:25 +0200 (CEST) Received: from pps.filterd (m0045851.ppops.net [127.0.0.1]) by mx0b-0016f401.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 46TBFTZU026225; Mon, 29 Jul 2024 04:47:24 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h= cc:content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=pfpt0220; bh=a Pc0uo1D/Lo2ltD9XIu4IvVyXHupMyvZJ2k8M75/vsQ=; b=Si72NXA5lQTp7a0vl Jl9Pm/TKok1k4WEULa7Nb+zgnaB1Jy4EYdYCn6rbe9wkCsBXoElxsw1o8BRBjZVa ixJvVZ7PG7rHGzEuQtI5fttg9yn3xljq5e+nnfWaqljk3HZ8welmYHdUdHrluifN NqGb81rP+razIISQ2mfxmeU7BsfB9G81VIxSpAVMtTtLQV+am7xwc7jT/6aEJV0E RtbQjXZbfF9bdgYhkTqpvRwWW6ZG/IngHeAPy6mvtZs7Mfvs3Buxw+2Osu6jIgVc xfWpl/8ZQUOrzudIj5SyDRpy/HHwqDeCGcC+AjJjXLvjp7Ig0hkEU85jg8JNWPeJ rTX0A== Received: from dc5-exch05.marvell.com ([199.233.59.128]) by mx0b-0016f401.pphosted.com (PPS) with ESMTPS id 40n0dqn3g4-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 29 Jul 2024 04:47:24 -0700 (PDT) Received: from DC5-EXCH05.marvell.com (10.69.176.209) by DC5-EXCH05.marvell.com (10.69.176.209) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1544.4; Mon, 29 Jul 2024 04:47:23 -0700 Received: from maili.marvell.com (10.69.176.80) by DC5-EXCH05.marvell.com (10.69.176.209) with Microsoft SMTP Server id 15.2.1544.4 via Frontend Transport; Mon, 29 Jul 2024 04:47:22 -0700 Received: from localhost.localdomain (unknown [10.28.36.177]) by maili.marvell.com (Postfix) with ESMTP id 71B6E3F7092; Mon, 29 Jul 2024 04:47:20 -0700 (PDT) From: Aakash Sasidharan To: CC: , , , , , , , Subject: [PATCH v3] doc: announce rte_ipsec API changes Date: Mon, 29 Jul 2024 17:17:19 +0530 Message-ID: <20240729114719.3461039-1-asasidharan@marvell.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20240723133706.2150828-1-asasidharan@marvell.com> References: <20240723133706.2150828-1-asasidharan@marvell.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Proofpoint-GUID: JlBxvXaa8Ws_A0IzHjtS7t6gj0rcWqGW X-Proofpoint-ORIG-GUID: JlBxvXaa8Ws_A0IzHjtS7t6gj0rcWqGW X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1039,Hydra:6.0.680,FMLib:17.12.28.16 definitions=2024-07-29_10,2024-07-26_01,2024-05-17_01 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 In case of event mode operations where event device can help in atomic sequence number increment across cores, sequence number need to be provided by the application instead of being updated in rte_ipsec or the PMD. To support this, two new APIs rte_ipsec_pkt_crypto_sqn_assign and rte_ipsec_pkt_crypto_xprepare are introduced decoupling the seq no update functionality from the existing rte_ipsec_pkt_crypto_prepare API. Additionally, a new flag ``RTE_IPSEC_SAFLAG_SQN_ASSIGN_DISABLE`` will be added to allow disabling of internal sequence number update inside IPsec library. Signed-off-by: Aakash Sasidharan --- doc/guides/rel_notes/deprecation.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 6948641ff6..9be7b90b94 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -133,6 +133,14 @@ Deprecation Notices Since these functions are not called directly by the application, the API remains unaffected. +* ipsec: The rte_ipsec library is updated to support sequence number provided + by application. To allow the same, two new APIs are being introduced: + rte_ipsec_pkt_crypto_sqn_assign and rte_ipsec_pkt_crypto_xprepare. These APIs + separate the seq no update functionality from the existing rte_ipsec_pkt_crypto_prepare + API. Corresponding configure structure changes are being made for the new APIs. + Additionally a new flag ``RTE_IPSEC_SAFLAG_SQN_ASSIGN_DISABLE`` is + introduced to disable sequence number assignment in lib IPsec. + * pipeline: The pipeline library legacy API (functions rte_pipeline_*) will be deprecated and subsequently removed in DPDK 24.11 release. Before this, the new pipeline library API (functions rte_swx_pipeline_*) -- 2.25.1