From patchwork Wed Jul 5 11:12:19 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Mattias_R=C3=B6nnblom?= X-Patchwork-Id: 129294 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id DC57B42DD7; Wed, 5 Jul 2023 13:18:31 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id AD6A64021F; Wed, 5 Jul 2023 13:18:31 +0200 (CEST) Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05on2089.outbound.protection.outlook.com [40.107.21.89]) by mails.dpdk.org (Postfix) with ESMTP id 176B740150 for ; Wed, 5 Jul 2023 13:18:30 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=fF4hCeTvqyXQ5q2A8UzNkq5MiZ6huCXnMR+ElSaSMby077Je5W+AzLS4V0VYECbcHzLlsQZ5lUZXfuDH4F2HjDuMW7GTPohJMY0gbJpBKQ/J7Xl213v5SAGhb3WurjpWrLUnmwnycf3pmvm0LlvlrUGUVzUhWzRfzSd/F7DaKOEW/Glrq6/hFRCwRaK0CslEpymLh0AzUAB/fjGlyJVkukdhyMw/99c5EZx0n9/Oqy/4oK4ptss8Mr+P9VW6p99d8cvNgBKiUSweos0zUiqrPykJu6aWwzXux/PsuoTi/aMr2i9a0oePJR8oHcpitz55dZHEnFkCbtGDh88AlgOJpg== 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:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=VENIKkT9wdur4mbfEFQr7Y80icpX26lcoDy+krTD4o8=; b=ESFEzSgcS+lBfy83ls/96aj1sARfkv2Czl3HLrZjpEOmPySsMsA0gaql/N/I9wXqIujQTs6pVEjK5eyrI8P4THBJjJE21nmJw7J30sNWyL9spiD9F9pWUEAxfz0gupsAXW35BTwixvcv2l6Vdo9S0K3lIsdWfHMP2Uync1DWX9PJHoH9Mx7bpk99UiEBv6CSUakBcxGD9WVqhjLeatNimLbQ7TaiaAcY/oyuHc5E7UPQ+urpmyPgBCXSO2cs1sCHERBVtZEfr9vovWiA4lcEeoexzk8mpdrcDl81dDHuS7jgdzB/J9PJS7FflPotiX8Rofu2N54Wug+2XQgjsj7cVA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 192.176.1.74) smtp.rcpttodomain=dpdk.org smtp.mailfrom=ericsson.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=ericsson.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ericsson.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=VENIKkT9wdur4mbfEFQr7Y80icpX26lcoDy+krTD4o8=; b=LlF+AXsX2c3OsmxfEwBDvD8FY8wBpg8WVrN7fFZ6ZCkTUNJS+Qbxm1hCe5/36+o+sJwr/2CB9DNRUKQ7LpXz5wZj5ELH2dIf2aZ1HUgla22owHpeJen1tfIB+z+sQrU53Cj1wcC5PeltlS1coHKWCI17hq85Scw+UkaY+v8x47M= Received: from DUZPR01CA0027.eurprd01.prod.exchangelabs.com (2603:10a6:10:46b::14) by DU2PR07MB9586.eurprd07.prod.outlook.com (2603:10a6:10:46c::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6544.24; Wed, 5 Jul 2023 11:18:28 +0000 Received: from DB5EUR02FT012.eop-EUR02.prod.protection.outlook.com (2603:10a6:10:46b:cafe::c0) by DUZPR01CA0027.outlook.office365.com (2603:10a6:10:46b::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6565.18 via Frontend Transport; Wed, 5 Jul 2023 11:18:28 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 192.176.1.74) smtp.mailfrom=ericsson.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=ericsson.com; Received-SPF: Pass (protection.outlook.com: domain of ericsson.com designates 192.176.1.74 as permitted sender) receiver=protection.outlook.com; client-ip=192.176.1.74; helo=oa.msg.ericsson.com; pr=C Received: from oa.msg.ericsson.com (192.176.1.74) by DB5EUR02FT012.mail.protection.outlook.com (10.13.58.69) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.20.6565.23 via Frontend Transport; Wed, 5 Jul 2023 11:18:28 +0000 Received: from ESESSMB501.ericsson.se (153.88.183.162) by ESESSMB505.ericsson.se (153.88.183.166) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.2507.27; Wed, 5 Jul 2023 13:18:27 +0200 Received: from seliicinfr00049.seli.gic.ericsson.se (153.88.183.153) by smtp.internal.ericsson.com (153.88.183.189) with Microsoft SMTP Server id 15.1.2507.27 via Frontend Transport; Wed, 5 Jul 2023 13:18:27 +0200 Received: from breslau.. (seliicwb00002.seli.gic.ericsson.se [10.156.25.100]) by seliicinfr00049.seli.gic.ericsson.se (Postfix) with ESMTP id 7C933380061; Wed, 5 Jul 2023 13:18:27 +0200 (CEST) From: =?utf-8?q?Mattias_R=C3=B6nnblom?= To: , Thomas Monjalon CC: Jerin Jacob , , , Pavan Nikhilesh , Timothy McDaniel , Hemant Agrawal , "Sachin Saxena" , Harry van Haaren , Liang Ma , Peter Mccarthy , =?utf-8?q?Mattias_R=C3=B6nnblom?= Subject: [PATCH v2] doc: announce single-event enqueue/dequeue ABI change Date: Wed, 5 Jul 2023 13:12:19 +0200 Message-ID: <20230705111219.245869-1-mattias.ronnblom@ericsson.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230705084816.245527-1-mattias.ronnblom@ericsson.com> References: <20230705084816.245527-1-mattias.ronnblom@ericsson.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DB5EUR02FT012:EE_|DU2PR07MB9586:EE_ X-MS-Office365-Filtering-Correlation-Id: 7c6a7394-c61c-40da-adaa-08db7d498ef8 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: GADbxjWQvVsz6p7BUFXyudjYOChGtsRweu0VLFy5bhVANuoaAuwXP+TAffWAaxlb6Ku1MrjOMo/wYo4hHO+++PwV4Anud8p2EtIg1w62O/S8okUkzn4y1IS0fsuFZ3PDrFKnL6pZEh8BH8CRbkllh0rs7J2AptUgZzto4/twvMakY9MYVe5e5+0uDS9VuzXGR2OI/3rk8qEeBHM4WFGSQC9KW7zqzEv455XUelXmbruV1D0t4DfO+y4h3oCVv1QPzmFY48Q9FLpKVVIdE2qndjpHgRjtdfLTn6ObO+Q1zYio4G+rOWu5270GH7cqPeg8cjB236z4lAdG5wZUzVqR4MG8yV76L2KCa6Vwcxgqw0Jp6hBbG8QOcHjdLFS9hqDctFaCOOY29zmpz7oDdQOhT0nlPkFuj1gDTiOeAQxa4eaZfvgIZ0qmyx1qOvdN1XnNkF7h1od2Xju3vjwDKrsIT6whmzw3saYg9osugzUFARsguoQ2QmNeV5k+txFrDrFZqa2Z9XPE+ZCLCe3cdlQBA0KVnT3zFtsau0MLAuRYa3iYOwdwk3qJ6+dZaxYzoH+n/l3tPZ5KfRqyJRIl7w3L14gzpAXobUHMFBVPkDQSDgWyJtLGTkA/uM0t39qURD3UolV1fHlFhuTrpZXgG+4JZKTG4lcAeMLjgjad42MVYGNyUhDyHSQd/fNaKwrRoGqA3Kn30NX6d1PxcT7liKf8zklvNn5uN3DlJJs2YzlgQeW0aDvoz5X/jNHBE97ejZiy3I6sOPah1GVhmk6lc0FeQwKKKlK3TItbLuwkXOfL418= X-Forefront-Antispam-Report: CIP:192.176.1.74; CTRY:SE; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:oa.msg.ericsson.com; PTR:office365.se.ericsson.net; CAT:NONE; SFS:(13230028)(4636009)(376002)(136003)(346002)(396003)(39860400002)(451199021)(40470700004)(36840700001)(46966006)(2906002)(110136005)(316002)(54906003)(5660300002)(107886003)(26005)(478600001)(86362001)(8936002)(4326008)(7416002)(8676002)(41300700001)(70586007)(70206006)(1076003)(36860700001)(6666004)(7636003)(40460700003)(47076005)(83380400001)(336012)(82960400001)(40480700001)(356005)(82740400003)(6266002)(2616005)(82310400005)(36756003)(186003); DIR:OUT; SFP:1101; X-OriginatorOrg: ericsson.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Jul 2023 11:18:28.7022 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 7c6a7394-c61c-40da-adaa-08db7d498ef8 X-MS-Exchange-CrossTenant-Id: 92e84ceb-fbfd-47ab-be52-080c6b87953f X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=92e84ceb-fbfd-47ab-be52-080c6b87953f; Ip=[192.176.1.74]; Helo=[oa.msg.ericsson.com] X-MS-Exchange-CrossTenant-AuthSource: DB5EUR02FT012.eop-EUR02.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DU2PR07MB9586 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 Announce the removal of the single-event enqueue and dequeue operations from the eventdev ABI. Signed-off-by: Mattias Rönnblom Acked-by: Jerin Jacob Acked-by: Pavan Nikhilesh Acked-by: Thomas Monjalon --- PATCH v2: Fix commit subject prefix. --- 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 66431789b0..ca192d838d 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -153,3 +153,11 @@ Deprecation Notices The new port library API (functions rte_swx_port_*) will gradually transition from experimental to stable status starting with DPDK 23.07 release. + +* eventdev: The single-event (non-burst) enqueue and dequeue + operations, used by static inline burst enqueue and dequeue + functions in , will be removed in DPDK 23.11. This + simplification includes changing the layout and potentially also the + size of the public rte_event_fp_ops struct, breaking the ABI. Since + these functions are not called directly by the application, the API + remains unaffected.