From patchwork Thu Mar 17 18:37:32 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Chautru, Nicolas" X-Patchwork-Id: 108771 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 DAEB5A034C; Thu, 17 Mar 2022 19:37:56 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 377EE41145; Thu, 17 Mar 2022 19:37:53 +0100 (CET) Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) by mails.dpdk.org (Postfix) with ESMTP id 47F7840040 for ; Thu, 17 Mar 2022 19:37:51 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1647542272; x=1679078272; h=from:to:cc:subject:date:message-id:in-reply-to: references; bh=bwoYMkHBFvuyfHBaNaHI2NAWY96KrgLogexQsDKCWhk=; b=V7uRHkBvSefbhfqHpv4kWfrkDQNTNcf6MTnikWSGq9sbfxba4rT81OWh QJ4HGfhjGl2dfOwEtukKM3JY8g/AJRdP7g4uPBX3aEGP2zepMK/+XLwgB vQREbsCcnrHET8612xziMXxPO9yiqYnV3uVmlUSZ5FH11Vi4dhgyzHshU 4d+GVozX8Ob9hpUxuIVdvpN2V/kHhl1+R7AXg+bFDI3n/SWbFDfBTJtus UMKz1LMO8VK96sjO/+RhOPWpbHW8N82oSB++YSMtl0B4I6mi60KmYxMlr jFI3Gos1wSKxgHyU3n8GLZW4KUsn+jwC8rUL772xIa0gVlslNRrOMl2q+ A==; X-IronPort-AV: E=McAfee;i="6200,9189,10289"; a="256679311" X-IronPort-AV: E=Sophos;i="5.90,188,1643702400"; d="scan'208";a="256679311" Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 17 Mar 2022 11:37:48 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.90,188,1643702400"; d="scan'208";a="513530598" Received: from skx-5gnr-sc12-4.sc.intel.com ([172.25.69.210]) by orsmga002.jf.intel.com with ESMTP; 17 Mar 2022 11:37:48 -0700 From: Nicolas Chautru To: dev@dpdk.org, gakhil@marvell.com, thomas@monjalon.net Cc: trix@redhat.com, ray.kinsella@intel.com, bruce.richardson@intel.com, hemant.agrawal@nxp.com, mingshan.zhang@intel.com, david.marchand@redhat.com, stephen@networkplumber.org, Nicolas Chautru Subject: [PATCH v2] doc: announce changes in bbdev related to enum extension Date: Thu, 17 Mar 2022 11:37:32 -0700 Message-Id: <1647542252-35727-2-git-send-email-nicolas.chautru@intel.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1647542252-35727-1-git-send-email-nicolas.chautru@intel.com> References: <1647542252-35727-1-git-send-email-nicolas.chautru@intel.com> 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 Intent to resolve in DPDK 22.11 historical usage which prevents graceful extension of enum and API without troublesome ABI breakage as well as extending API RTE_BBDEV_OP_FFT for new operation type in bbdev. Signed-off-by: Nicolas Chautru --- 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 4e5b23c..ff161c5 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -112,6 +112,14 @@ Deprecation Notices session and the private data of session. An opaque pointer can be exposed directly to application which can be attached to the ``rte_crypto_op``. +* bbdev: Will fix extending some enum breaking the ABI. Notably + deprecating ``RTE_BBDEV_OP_TYPE_COUNT`` terminating the ``rte_bbdev_op_type`` + and use fixed array size when required to allow for future enum extension. + Will also remove some of the inlining when causing ABI future-proof concerns. + Will extend API to support new operation type ``RTE_BBDEV_OP_FFT`` as per this + RFC https://patchwork.dpdk.org/project/dpdk/list/?series=22111 + This should be updated in DPDK 22.11. + * security: Hide structure ``rte_security_session`` and expose an opaque pointer for the private data to the application which can be attached to the packet while enqueuing.