From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 8F220A00E6 for ; Thu, 8 Aug 2019 10:59:08 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 0FD644C8F; Thu, 8 Aug 2019 10:59:08 +0200 (CEST) Received: from mx0b-0016f401.pphosted.com (mx0a-0016f401.pphosted.com [67.231.148.174]) by dpdk.org (Postfix) with ESMTP id 879002C02 for ; Thu, 8 Aug 2019 10:59:06 +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 x788toJi030114; Thu, 8 Aug 2019 01:59:05 -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=gJCovMx9NzljJ9ZumNc4G7JE0xcLuwD5ZMIYu70bs9k=; b=RLFa38gfa8Bw42CNnw+DSPxe5EjIqcNb3tgD3WzKn0hpHHUru0j1hyry5+V6p/kc0iEj Wo0OpSv2f9+M9l6FFFFuQd+bK+fzBj0v6s3W1Jzvt0si1TxAY5arvhMxxy4mw4scZVMG 4MkbsI9vm4HHvSI3xE+na0VJgTb2qapVITstXCAtjlOUd6mhpCDCUlK3fUvIXKlejQoA PchKHhIGSO+UnSgUrL2d+8Oe/sT660vXh5z/ulX91ZZaH4g5KDA5XbH3rsufHFOwNCen hBzT52kf8XiX13V+ftETB2FzSf/SEN37xtbjvXuXVb/ZF5LDeHLa/ZZYac3pWDYzi4VT ew== Received: from sc-exch01.marvell.com ([199.233.58.181]) by mx0a-0016f401.pphosted.com with ESMTP id 2u8cqj8snr-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Thu, 08 Aug 2019 01:59:05 -0700 Received: from SC-EXCH01.marvell.com (10.93.176.81) by SC-EXCH01.marvell.com (10.93.176.81) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Thu, 8 Aug 2019 01:59:04 -0700 Received: from maili.marvell.com (10.93.176.43) by SC-EXCH01.marvell.com (10.93.176.81) with Microsoft SMTP Server id 15.0.1367.3 via Frontend Transport; Thu, 8 Aug 2019 01:59:04 -0700 Received: from BG-LT7430.marvell.com (unknown [10.28.17.51]) by maili.marvell.com (Postfix) with ESMTP id 049AA3F703F; Thu, 8 Aug 2019 01:59:00 -0700 (PDT) From: To: , , , , , , , Neil Horman , John McNamara , "Marko Kovacevic" CC: , Pavan Nikhilesh Date: Thu, 8 Aug 2019 14:28:58 +0530 Message-ID: <20190808085859.796-1-pbhagavatula@marvell.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20190808081752.516-1-pbhagavatula@marvell.com> References: <20190808081752.516-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_05:2019-08-07,2019-08-08 signatures=0 Subject: [dpdk-dev] [patch v3] 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 --- v3 Changes: - DEV_RX_OFFLOAD_RSS -> DEV_RX_OFFLOAD_RSS_HASH (anndrew). v2 Changes: - 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..056c5709f 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_HASH`` + 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