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 46917A00E6
	for <public@inbox.dpdk.org>; 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 <dev@dpdk.org>; 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" <konstantin.ananyev@intel.com>
To: "pbhagavatula@marvell.com" <pbhagavatula@marvell.com>,
 "jerinj@marvell.com" <jerinj@marvell.com>, "stephen@networkplumber.org"
 <stephen@networkplumber.org>, "arybchenko@solarflare.com"
 <arybchenko@solarflare.com>, "hemant.agrawal@nxp.com"
 <hemant.agrawal@nxp.com>, "thomas@monjalon.net" <thomas@monjalon.net>,
 "Yigit, Ferruh" <ferruh.yigit@intel.com>, "Richardson, Bruce"
 <bruce.richardson@intel.com>, Neil Horman <nhorman@tuxdriver.com>,
 "Mcnamara, John" <john.mcnamara@intel.com>, "Kovacevic, Marko"
 <marko.kovacevic@intel.com>
CC: "dev@dpdk.org" <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 <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>


> 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 <pbhagavatula@marvell.com>
> Acked-by: Andrew Rybchenko <arybchenko@solarflare.com>
> Acked-by: Jerin Jacob <jerinj@marvell.com>
> Acked-by: Hemant Agrawal <hemant.agrawal@nxp.com>
> ---
>  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 <konstantin.ananyev@intel.com>

> 2.17.1