From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by dpdk.org (Postfix) with ESMTP id 0AB512C18 for ; Tue, 20 Mar 2018 15:03:06 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 20 Mar 2018 07:02:57 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.48,335,1517904000"; d="scan'208";a="35351048" Received: from fyigit-mobl.ger.corp.intel.com (HELO [10.237.221.63]) ([10.237.221.63]) by FMSMGA003.fm.intel.com with ESMTP; 20 Mar 2018 07:02:56 -0700 To: Shahaf Shuler , Neil Horman , John McNamara , Marko Kovacevic Cc: "dev@dpdk.org" , Thomas Monjalon References: <20171017142414.127705-1-shahafs@mellanox.com> <20180316153141.124657-1-ferruh.yigit@intel.com> From: Ferruh Yigit Message-ID: <6e80ead7-05b4-1724-6427-a01269134c84@intel.com> Date: Tue, 20 Mar 2018 14:02:55 +0000 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Mar 2018 14:03:07 -0000 On 3/18/2018 5:57 AM, Shahaf Shuler wrote: > Hi Ferruh, > > Friday, March 16, 2018 5:32 PM, Ferruh Yigit: >> Subject: [PATCH] doc: reduce initial offload API scope to drivers >> >> 18.05 tagets ethdev-PMD offload API, which means switching all PMDs to >> new offloading API >> >> Next step targets ethdev-application offload API which means forcing >> applications to switch to new API >> >> Fixes: 3004d3454192 ("doc: update deprecation of ethdev offload API") >> Cc: shahafs@mellanox.com >> >> Signed-off-by: Ferruh Yigit >> --- >> doc/guides/rel_notes/deprecation.rst | 7 ++++++- >> 1 file changed, 6 insertions(+), 1 deletion(-) >> >> 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 offloads. >> Offloads are disabled by default and enabled per application request. >> - The old offloads API is target to be deprecated on 18.05. This includes: >> + The old offloads API between ethdev and drivers is target to be >> deprecated on 18.05. >> + This includes: >> >> + - removal of the conversion in ethdev from new offloading API to old API. > > 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. There are two conversion done in ethdev: 1) From old API to new API 2) From new API to old API so that PMDs can have access to both old and new API independent from what application provided. Above text suggesting to remove only 2). If we switch all PMDs to new API we don't need conversion 2) anymore. If application using new API we are all good, for old application that using old API ethdev will convert to new API so that PMDs can use them. > >> + >> + 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 PMDs conversion to the new API in the current/next one. > >> -- >> 2.13.6 >