From patchwork Fri Jul 15 20:30:55 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Ding, Xuan" X-Patchwork-Id: 113988 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 19E38A0032; Fri, 15 Jul 2022 22:31:06 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id A0A8540A87; Fri, 15 Jul 2022 22:31:05 +0200 (CEST) Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by mails.dpdk.org (Postfix) with ESMTP id 626C440141 for ; Fri, 15 Jul 2022 22:31:04 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1657917064; x=1689453064; h=from:to:cc:subject:date:message-id:in-reply-to: references; bh=28heSXMqC5N2LsRd6b1wX42623Vr2kCY3vzMDV2FUDs=; b=CQYHsiRjKzXXcNPWjPrIIAiCn2pCduiKhpUZjFLUb6vYLYLm/sNOzu76 QA1dhJ9V93t3Pbk4srBQkyz3F5/LK0kE/Xh8WgThecyHRO0UdmNNtLlzC VfZ5AjPxa7EMPpCw2noaMpVdCvvCT5kY0G5ZP4NR5ZeDPPZIC6tZ8v1ni KJEoEEQn+7x+ZazMDZpOSzP+4LxP3UcCSjHDSMl2Q7gRXbg9rEIRVPsBF JaDvvSzd5VE+3070RZqRrMmZcpwC3BnAnSBwPRthqiYYx1VQI2Xvhq/Sy zV33bQJM8q4TjX1WlvWVTu367nFTUMBRzvsZ807CLR/Pj//eNcQJnCWt4 w==; X-IronPort-AV: E=McAfee;i="6400,9594,10409"; a="311562144" X-IronPort-AV: E=Sophos;i="5.92,274,1650956400"; d="scan'208";a="311562144" Received: from orsmga005.jf.intel.com ([10.7.209.41]) by fmsmga101.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 15 Jul 2022 13:31:03 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.92,274,1650956400"; d="scan'208";a="773107542" Received: from npg-dpdk-xuan-cbdma.sh.intel.com ([10.67.111.163]) by orsmga005.jf.intel.com with ESMTP; 15 Jul 2022 13:30:59 -0700 From: xuan.ding@intel.com To: thomas@monjalon.net, mdr@ashroe.eu, andrew.rybchenko@oktetlabs.ru, ferruh.yigit@xilinx.com, viacheslavo@nvidia.com Cc: dev@dpdk.org, stephen@networkplumber.org, mb@smartsharesystems.com, qi.z.zhang@intel.com, asekhar@marvell.com, pbhagavatula@marvell.com, Xuan Ding Subject: [PATCH v2] doc: announce header split deprecation Date: Fri, 15 Jul 2022 20:30:55 +0000 Message-Id: <20220715203055.64074-1-xuan.ding@intel.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20220523142016.44451-1-xuan.ding@intel.com> References: <20220523142016.44451-1-xuan.ding@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 From: Xuan Ding RTE_ETH_RX_OFFLOAD_HEADER_SPLIT offload was introduced some time ago to substitute bit-field header_split in struct rte_eth_rxmode. It allows to enable per-port header split offload with the header size controlled using split_hdr_size in the same structure. Right now, no single PMD actually supports RTE_ETH_RX_OFFLOAD_HEADER_SPLIT with above definition. Many examples and test apps initialize the field to 0 explicitly. The most of drivers simply ignore split_hdr_size since the offload is not advertised, but some double-check that its value is 0. So the RTE_ETH_RX_OFFLOAD_HEADER_SPLIT and split_header_size field will be removed in DPDK 22.11. After DPDK 22.11 LTS, the RTE_ETH_RX_OFFLOAD_BUFFER_SPLIT can still be used for per-queue Rx packet split offload, which is configured by rte_eth_rxseg_split. Signed-off-by: Xuan Ding Acked-by: Ray Kinsella Acked-by: Andrew Rybchenko Acked-by: Ferruh Yigit Acked-by: Viacheslav Ovsiienko Acked-by: Thomas Monjalon --- v2: * Refine doc to mention remained RTE_ETH_RX_OFFLOAD_BUFFER_SPLIT. --- doc/guides/rel_notes/deprecation.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 1e5e532e60..ae37559275 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -158,3 +158,10 @@ Deprecation Notices applications should be updated to use the ``dmadev`` library instead, with the underlying HW-functionality being provided by the ``ioat`` or ``idxd`` dma drivers + +* ethdev: Since no single PMD supports ``RTE_ETH_RX_OFFLOAD_HEADER_SPLIT`` offload +and the ``split_hdr_size`` field in structure ``rte_eth_rxmode`` to enable per-port +header split as they were designed, they will be removed in DPDK 22.11. +After DPDK 22.11 LTS, the ``RTE_ETH_RX_OFFLOAD_BUFFER_SPLIT`` can still be +used for per-queue Rx packet split offload, and it is configured +by ``rte_eth_rxseg_split``.