From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <shahafs@mellanox.com>
Received: from EUR03-DB5-obe.outbound.protection.outlook.com
 (mail-eopbgr40046.outbound.protection.outlook.com [40.107.4.46])
 by dpdk.org (Postfix) with ESMTP id B37F85F17
 for <dev@dpdk.org>; Sun, 18 Mar 2018 06:57:41 +0100 (CET)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Mellanox.com;
 s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version;
 bh=4wgV0f8S8Kq4fx4SOzU2ODK/NPvOq6SyyhsyAkUVXOE=;
 b=PI3b7KrnsV8Dy7DulI2lt7LchUl/SrcKwkV4T5RuHIrIOiMl4KQc8WOU0A5y0kBmhwGWWPvtAKnBoSMTYyJmyhqZT1sFZ39XIHnwUWwd+QihP2JuYk+SodfThKcr0CWo4r9fXWVpOPOcJ9xxtxPqZFVAx6+ILLbFEE6qLyx9EwE=
Received: from DB7PR05MB4426.eurprd05.prod.outlook.com (52.134.109.15) by
 DB7PR05MB4508.eurprd05.prod.outlook.com (52.134.109.142) with Microsoft SMTP
 Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id
 15.20.588.14; Sun, 18 Mar 2018 05:57:38 +0000
Received: from DB7PR05MB4426.eurprd05.prod.outlook.com
 ([fe80::3473:b2b5:68f:fe6e]) by DB7PR05MB4426.eurprd05.prod.outlook.com
 ([fe80::3473:b2b5:68f:fe6e%13]) with mapi id 15.20.0588.016; Sun, 18 Mar 2018
 05:57:38 +0000
From: Shahaf Shuler <shahafs@mellanox.com>
To: Ferruh Yigit <ferruh.yigit@intel.com>, Neil Horman
 <nhorman@tuxdriver.com>, John McNamara <john.mcnamara@intel.com>, "Marko
 Kovacevic" <marko.kovacevic@intel.com>
CC: "dev@dpdk.org" <dev@dpdk.org>, Thomas Monjalon <thomas@monjalon.net>
Thread-Topic: [PATCH] doc: reduce initial offload API scope to drivers
Thread-Index: AQHTvTvpxf3Dy6/zZUKeIVRLdkzQzKPVgHsg
Date: Sun, 18 Mar 2018 05:57:38 +0000
Message-ID: <DB7PR05MB4426388F64BA6DC91B494D53C3D50@DB7PR05MB4426.eurprd05.prod.outlook.com>
References: <20171017142414.127705-1-shahafs@mellanox.com>
 <20180316153141.124657-1-ferruh.yigit@intel.com>
In-Reply-To: <20180316153141.124657-1-ferruh.yigit@intel.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
authentication-results: spf=none (sender IP is )
 smtp.mailfrom=shahafs@mellanox.com; 
x-originating-ip: [31.154.10.107]
x-ms-publictraffictype: Email
x-microsoft-exchange-diagnostics: 1; DB7PR05MB4508;
 6:pr4C3gHbDTZ7vUdJb6wMPbP8Q8CTlTKit4c65UnuNSIF9ckn86ZNviDFzw7usEJqw6pvE+XNSjotodLa8VfuqWa23h8MUHYaXX/T98oKcTInDdD1kmdJDbdpgypkH1LYeIFXDq7QbAyP6CAp0rFTt1bRJ8u8x4p2xhZVl4e6UkXEqt11TZpizziZo3Rg2tj49NYLkSWr6syA4AKXmqJKfUR46Z39DGlVoas6pMcfm0pO6jO0s2eq0nwklEe0mXiGl761WR4y8DeGfcsFn2zUhbeLYRqEcfpzLF1SHilP9brRPL8xbMFwRVhMg4/Z1+74VIyBAXcAyL/j0ozSO8AtStX4s9ZxVgEZuUd6p0Kn7u3XnZbVxvC2Z9rgVyPMi5UJ;
 5:HUDx10pISUBdpFtMZ+qB8LhrpqSNCwTECbM7YkHuy098w8186i2VEtbjETcDCe1PJCW+SkISbkNyB5LC2JxsHQ1M4juHh2xF7nGV0KgRGJpgH6UUMHi34G+U+JjL1CBBn5uXfyWuKd04H3TcrK96tuyMyZmYDX9KCJhjv4mwLl8=;
 24:L7zW+AKMOgpe31CA3ZJLc0ONM/ldqzh/wOpXi4zq1Y4oF+LTpjcsyP88iQDTYVYJfWmvTJ1l1IE2M6WeFGIu0ABqlGs8H9ppltz+2UkPow8=;
 7:yjnR9ZiGNQ4ipvrsfNNaaPlyapAZDiIhUGYrfLu2GjQRAw+q9+Gmt4zUV4679JmLLt4+Uk9PH2XRupQtwbnp/nDoQqn4+vaD08TVcFMr4LQG6BIo3k6wmh5pu0MjErLx6MBn+GufHUBcKWC0A+jcbT4+iia1C/hwitz8bMGF8BsqfXZL9hVLRXJsm/elu61T5KlmonDAuSWKiIM1KRc+mkkZ6tlEnoBPbbWF0dMlmOngXXR55RUDns7LgCEXq8qQ
x-ms-exchange-antispam-srfa-diagnostics: SOS;
x-ms-office365-filtering-ht: Tenant
x-ms-office365-filtering-correlation-id: a4204ba4-2fc1-42e7-f649-08d58c9527b7
x-microsoft-antispam: UriScan:; BCL:0; PCL:0;
 RULEID:(7020095)(4652020)(48565401081)(5600026)(4604075)(3008032)(4534165)(4627221)(201703031133081)(201702281549075)(2017052603328)(7153060)(7193020);
 SRVR:DB7PR05MB4508; 
x-ms-traffictypediagnostic: DB7PR05MB4508:
x-ld-processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr
x-microsoft-antispam-prvs: <DB7PR05MB4508B80752EBF1B595DF8A83C3D50@DB7PR05MB4508.eurprd05.prod.outlook.com>
x-exchange-antispam-report-test: UriScan:(278428928389397)(228905959029699);
x-exchange-antispam-report-cfa-test: BCL:0; PCL:0;
 RULEID:(8211001083)(6040522)(2401047)(5005006)(8121501046)(3002001)(93006095)(93001095)(10201501046)(3231221)(944501300)(52105095)(6055026)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123558120)(20161123564045)(20161123560045)(20161123562045)(6072148)(201708071742011);
 SRVR:DB7PR05MB4508; BCL:0; PCL:0; RULEID:; SRVR:DB7PR05MB4508; 
x-forefront-prvs: 06157D541C
x-forefront-antispam-report: SFV:NSPM;
 SFS:(10009020)(396003)(376002)(39380400002)(346002)(366004)(39860400002)(199004)(189003)(9686003)(305945005)(26005)(81166006)(105586002)(81156014)(106356001)(3846002)(6116002)(76176011)(97736004)(8936002)(8676002)(2906002)(7736002)(5250100002)(59450400001)(478600001)(3660700001)(86362001)(5660300001)(74316002)(99286004)(6506007)(2950100002)(3280700002)(66066001)(186003)(33656002)(110136005)(6436002)(102836004)(25786009)(316002)(2900100001)(55016002)(229853002)(6246003)(54906003)(4326008)(68736007)(14454004)(7696005)(53936002);
 DIR:OUT; SFP:1101; SCL:1; SRVR:DB7PR05MB4508;
 H:DB7PR05MB4426.eurprd05.prod.outlook.com; FPR:; SPF:None; PTR:InfoNoRecords;
 A:1; MX:1; LANG:en; 
received-spf: None (protection.outlook.com: mellanox.com does not designate
 permitted sender hosts)
x-microsoft-antispam-message-info: Smv1HBEPqhXDyMvbJil97tM/SaF7igdCU+J4t4kUYTQj5HXi+gQL3ON6tDVqqf/M6wBV4w7ejet0SMN1CNTrLxpqvXX4R360OfXb/i7gk5tIE+Tx/aFhVS3Nd8mKK6VlOPHEgA0JAtAtp9UfY42oFuZwlhE+6oYPEw6YxSAFncXO+3U+Uow0odbzRoNqXvS/IAe/IG3ciPQm9UOu47nup15Y4QIDFCkf4AyoiKxlBzD80DvaeRwnPBGj8Qis95WIzi/rZqxa8NVSRRARKsVBsH9HrsknzQ/T+PI/wQrV1Vlv5zhPgU4RxuBTaZhKPANAEaDzgk8+yye0B53Y3Y6Z0g==
spamdiagnosticoutput: 1:99
spamdiagnosticmetadata: NSPM
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-OriginatorOrg: Mellanox.com
X-MS-Exchange-CrossTenant-Network-Message-Id: a4204ba4-2fc1-42e7-f649-08d58c9527b7
X-MS-Exchange-CrossTenant-originalarrivaltime: 18 Mar 2018 05:57:38.5926 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: a652971c-7d2e-4d9b-a6a4-d149256f461b
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR05MB4508
Subject: Re: [dpdk-dev] [PATCH] doc: reduce initial offload API scope to
	drivers
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://dpdk.org/ml/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
X-List-Received-Date: Sun, 18 Mar 2018 05:57:41 -0000

Hi Ferruh,

Friday, March 16, 2018 5:32 PM, Ferruh Yigit:
> Subject: [PATCH] doc: reduce initial offload API scope to drivers
>=20
> 18.05 tagets ethdev-PMD offload API, which means switching all PMDs to
> new offloading API
>=20
> Next step targets ethdev-application offload API which means forcing
> applications to switch to new API
>=20
> Fixes: 3004d3454192 ("doc: update deprecation of ethdev offload API")
> Cc: shahafs@mellanox.com
>=20
> Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
> ---
>  doc/guides/rel_notes/deprecation.rst | 7 ++++++-
>  1 file changed, 6 insertions(+), 1 deletion(-)
>=20
> diff --git a/doc/guides/rel_notes/deprecation.rst
> b/doc/guides/rel_notes/deprecation.rst
> index 0c696f743..b40c57f28 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -97,8 +97,13 @@ Deprecation Notices
>  * ethdev: a new Tx and Rx offload API was introduced on 17.11.
>    In the new API, offloads are divided into per-port and per-queue offlo=
ads.
>    Offloads are disabled by default and enabled per application request.
> -  The old offloads API is target to be deprecated on 18.05. This include=
s:
> +  The old offloads API between ethdev and drivers is target to be
> deprecated on 18.05.
> +  This includes:
>=20
> +  - removal of the conversion in ethdev from new offloading API to old A=
PI.

We cannot remove this part before all of the applications has moved to the =
new API.
The conversion function is to help PMDs to have single control path with no=
 branch for both old and new application.=20

> +
> +  In later releases the old offloading API between ethdev and
> + applications will be  deprecated too, which will include:
>    - removal of ``ETH_TXQ_FLAGS_NO*`` flags.
>    - removal of ``txq_flags`` field from ``rte_eth_txconf`` struct.
>    - removal of the offloads bit-field from ``rte_eth_rxmode`` struct.

I am OK with postponing the deprecation to a later release and have the PMD=
s conversion to the new API in the current/next one.=20

> --
> 2.13.6