From patchwork Thu Aug 8 08:17:52 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Pavan Nikhilesh Bhagavatula X-Patchwork-Id: 57554 Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A9291137C; Thu, 8 Aug 2019 10:18:03 +0200 (CEST) Received: from mx0b-0016f401.pphosted.com (mx0a-0016f401.pphosted.com [67.231.148.174]) by dpdk.org (Postfix) with ESMTP id CE86B3DC for ; Thu, 8 Aug 2019 10:18:01 +0200 (CEST) Received: from pps.filterd (m0045849.ppops.net [127.0.0.1]) by mx0a-0016f401.pphosted.com (8.16.0.42/8.16.0.42) with SMTP id x788AKOv001034; Thu, 8 Aug 2019 01:18:01 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-transfer-encoding : content-type; s=pfpt0818; bh=sFz/YtWDUTuJlJqOzuHC7s4O0K7raVTONQoJR2GJ1wU=; b=Sn+Zb0kpESSgnKGaRzeVq9ZRZjDJQU2cuOu6bm/9PkGbm63msZKTSqCSZZ0JzJF/9dqL 1GhWak67TR2TzK1WdL7OKuYgXU4NTx8IXcQyGnuzNoDxGBwioKSXzk9j4A16IbBCej4H qAzrGVOkOwnOsQM3/yrapFdKYNEvGS1yPUlvLuFykWK2dKY9NOgrQytt6cocuiRjO398 XeKFrelbbMqm1Dg6FOKZCm3Q+461O364hCZccY1kGwQYs1bTVjuQfCFZmv46PcoiJM8R kccPxITRMuMgKDyhjwGMcYIv6GFPWnvWzbA53SKM/ZQTgl93pLq//xIBbSnBq23MeNK0 HA== Received: from sc-exch03.marvell.com ([199.233.58.183]) by mx0a-0016f401.pphosted.com with ESMTP id 2u8cqj8nqn-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Thu, 08 Aug 2019 01:18:00 -0700 Received: from SC-EXCH03.marvell.com (10.93.176.83) by SC-EXCH03.marvell.com (10.93.176.83) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Thu, 8 Aug 2019 01:17:59 -0700 Received: from maili.marvell.com (10.93.176.43) by SC-EXCH03.marvell.com (10.93.176.83) with Microsoft SMTP Server id 15.0.1367.3 via Frontend Transport; Thu, 8 Aug 2019 01:17:59 -0700 Received: from BG-LT7430.marvell.com (unknown [10.28.17.51]) by maili.marvell.com (Postfix) with ESMTP id 9A7AE3F7040; Thu, 8 Aug 2019 01:17:54 -0700 (PDT) From: To: , , , , , , , Neil Horman , John McNamara , "Marko Kovacevic" CC: , Pavan Nikhilesh Date: Thu, 8 Aug 2019 13:47:52 +0530 Message-ID: <20190808081752.516-1-pbhagavatula@marvell.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20190807160927.1197-1-pbhagavatula@marvell.com> References: <20190807160927.1197-1-pbhagavatula@marvell.com> MIME-Version: 1.0 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:5.22.84,1.0.8 definitions=2019-08-08_04:2019-08-07,2019-08-08 signatures=0 Subject: [dpdk-dev] [patch v2] doc: announce API change in ethdev offload flags X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" From: Pavan Nikhilesh Add new offload flags ``DEV_RX_OFFLOAD_PTYPE``, ``DEV_RX_OFFLOAD_RSS`` and ``DEV_RX_OFFLOAD_FLOW_MARK``. Signed-off-by: Pavan Nikhilesh Acked-by: Andrew Rybchenko Acked-by: Jerin Jacob --- v2: Reword for clarity. doc/guides/rel_notes/deprecation.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) -- 2.17.1 diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 37b8592b6..79e50a272 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -78,3 +78,16 @@ Deprecation Notices to set new power environment if power environment was already initialized. In this case the function will return -1 unless the environment is unset first (using ``rte_power_unset_env``). Other function usage scenarios will not change. + +* ethdev: New offload flags ``DEV_RX_OFFLOAD_PTYPE``, ``DEV_RX_OFFLOAD_RSS`` + and ``DEV_RX_OFFLOAD_FLOW_MARK`` will be added in 19.11. + This will allow application to enable or disable PMDs from updating + ``rte_mbuf`` fields ``rte_mbuf::packet_type``, ``rte_mbuf::hash::rss`` and + ``rte_mbuf::hash::fdir`` respectively. + This scheme will allow PMDs to avoid writes to ``rte_mbuf`` fields on Rx and + thereby improve Rx performance if application wishes do so. + In 19.11 PMDs will still update the fields even when the offloads are not + enabled. + The exact semantics of the flags will be worked out later either by making + them negative offloads to avoid application change or positive offload to + align with existing offload flag semantics.