From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from dpdk.org (dpdk.org [92.243.14.124])
	by inbox.dpdk.org (Postfix) with ESMTP id 4818DA00E6
	for <public@inbox.dpdk.org>; Thu,  8 Aug 2019 10:18:04 +0200 (CEST)
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 <dev@dpdk.org>; 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: <pbhagavatula@marvell.com>
To: <jerinj@marvell.com>, <stephen@networkplumber.org>,
 <arybchenko@solarflare.com>, <hemant.agrawal@nxp.com>,
 <thomas@monjalon.net>, <ferruh.yigit@intel.com>,
 <bruce.richardson@intel.com>, Neil Horman <nhorman@tuxdriver.com>,
 John McNamara <john.mcnamara@intel.com>, "Marko
 Kovacevic" <marko.kovacevic@intel.com>
CC: <dev@dpdk.org>, Pavan Nikhilesh <pbhagavatula@marvell.com>
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
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
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 <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>

From: Pavan Nikhilesh <pbhagavatula@marvell.com>

Add new offload flags ``DEV_RX_OFFLOAD_PTYPE``, ``DEV_RX_OFFLOAD_RSS``
and ``DEV_RX_OFFLOAD_FLOW_MARK``.

Signed-off-by: Pavan Nikhilesh <pbhagavatula@marvell.com>
Acked-by: Andrew Rybchenko <arybchenko@solarflare.com>
---
 v2: Reword for clarity.

 doc/guides/rel_notes/deprecation.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

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.
--
2.17.1