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 46917A00E6 for ; Fri, 9 Aug 2019 12:13:46 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 6BD49231E; Fri, 9 Aug 2019 12:13:45 +0200 (CEST) Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by dpdk.org (Postfix) with ESMTP id 05F722AB for ; Fri, 9 Aug 2019 12:13:43 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga003.jf.intel.com ([10.7.209.27]) by fmsmga101.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 09 Aug 2019 03:13:42 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.64,364,1559545200"; d="scan'208";a="177597436" Received: from irsmsx109.ger.corp.intel.com ([163.33.3.23]) by orsmga003.jf.intel.com with ESMTP; 09 Aug 2019 03:13:40 -0700 Received: from irsmsx112.ger.corp.intel.com (10.108.20.5) by IRSMSX109.ger.corp.intel.com (163.33.3.23) with Microsoft SMTP Server (TLS) id 14.3.439.0; Fri, 9 Aug 2019 11:13:39 +0100 Received: from irsmsx105.ger.corp.intel.com ([169.254.7.164]) by irsmsx112.ger.corp.intel.com ([169.254.1.38]) with mapi id 14.03.0439.000; Fri, 9 Aug 2019 11:13:39 +0100 From: "Ananyev, Konstantin" To: "pbhagavatula@marvell.com" , "jerinj@marvell.com" , "stephen@networkplumber.org" , "arybchenko@solarflare.com" , "hemant.agrawal@nxp.com" , "thomas@monjalon.net" , "Yigit, Ferruh" , "Richardson, Bruce" , Neil Horman , "Mcnamara, John" , "Kovacevic, Marko" CC: "dev@dpdk.org" Thread-Topic: [dpdk-dev] [patch v5] doc: announce API change in ethdev offload flags Thread-Index: AQHVTpi2XWyU5firvUOv0/yOTk5BS6bymMEw Date: Fri, 9 Aug 2019 10:13:39 +0000 Message-ID: <2601191342CEEE43887BDE71AB9772580168A64198@irsmsx105.ger.corp.intel.com> References: <20190809081740.1607-1-pbhagavatula@marvell.com> <20190809095559.1900-1-pbhagavatula@marvell.com> In-Reply-To: <20190809095559.1900-1-pbhagavatula@marvell.com> Accept-Language: en-IE, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiMjYzNzE0MDQtNzQ1Ni00MzRlLWE4MWMtOGY5MTNjMWZmMGVmIiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX05UIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE3LjEwLjE4MDQuNDkiLCJUcnVzdGVkTGFiZWxIYXNoIjoiSmxVWjhTZnJjdzJRdys0N0grYWxJVFlGVXhHSkJhUU9MalZhckZ3YTRHY3htc0pGeUpKZWZLVkl4UFpvMmNOVCJ9 x-ctpclassification: CTP_NT dlp-product: dlpe-windows dlp-version: 11.2.0.6 dlp-reaction: no-action x-originating-ip: [163.33.239.180] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [patch v5] 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" > Add new offload flags ``DEV_RX_OFFLOAD_RSS_HASH`` and > ``DEV_RX_OFFLOAD_FLOW_MARK``. > Add new function ``rte_eth_dev_set_supported_ptypes`` to allow applicatio= n > to set specific ptypes to be updated in ``rte_mbuf::packet_type`` >=20 > Signed-off-by: Pavan Nikhilesh > Acked-by: Andrew Rybchenko > Acked-by: Jerin Jacob > Acked-by: Hemant Agrawal > --- > v5 Changes: > - Reword for clarity. >=20 > v4 Changes: > - Remove DEV_RX_OFFLOAD_PTYPE proposition and replace it with > rte_eth_dev_set_supported_ptypes (Konstantin). >=20 > v3 Changes: > - DEV_RX_OFFLOAD_RSS -> DEV_RX_OFFLOAD_RSS_HASH (andrew). >=20 > v2 Changes: > - Reword for clarity. >=20 > doc/guides/rel_notes/deprecation.rst | 24 ++++++++++++++++++++++++ > 1 file changed, 24 insertions(+) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/= deprecation.rst > index 37b8592b6..b0391366c 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -78,3 +78,27 @@ Deprecation Notices > to set new power environment if power environment was already initiali= zed. > In this case the function will return -1 unless the environment is uns= et first > (using ``rte_power_unset_env``). Other function usage scenarios will n= ot change. > + > +* ethdev: New offload flags ``DEV_RX_OFFLOAD_RSS_HASH`` and ``DEV_RX_OFF= LOAD_FLOW_MARK`` > + will be added in 19.11. > + This will allow application to enable or disable PMDs from updating > + ``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. > + > +* ethdev: New function ``rte_eth_dev_set_supported_ptypes`` will be adde= d in > + 19.11. > + This will allow application to request PMD to set specific ptypes defi= ned > + through ``rte_eth_dev_set_supported_ptypes`` in ``rte_mbuf::packet_typ= e``. > + If application doesn't want any ptype information it can call > + ``rte_eth_dev_set_supported_ptypes(ethdev_id, RTE_PTYPE_UNKNOWN)`` and= PMD > + will set ``rte_mbuf::packet_type`` to ``0``. > + If application doesn't call ``rte_eth_dev_set_supported_ptypes`` PMD c= an > + return ``rte_mbuf::packet_type`` with ``rte_eth_dev_get_supported_ptyp= es``. > + If application is interested only in L2/L3 layer, it can inform the PM= D to update > + ``rte_mbuf::packet_type`` with L2/L3 ptype by calling > + ``rte_eth_dev_set_supported_ptypes(ethdev_id, RTE_PTYPE_L2_MASK | RTE_P= TYPE_L3_MASK)``. > + This scheme will allow PMDs to avoid lookup to internal ptype table on= Rx and > + thereby improve Rx performance if application wishes do so. > -- Acked-by: Konstantin Ananyev > 2.17.1