From mboxrd@z Thu Jan  1 00:00:00 1970
From: "Yang, Zhiyong" <zhiyong.yang@intel.com>
Subject: Re: [PATCH v2] doc: announce API and ABI change for
 ethdev
Date: Mon, 7 Aug 2017 03:07:25 +0000
Message-ID: <E182254E98A5DA4EB1E657AC7CB9BD2A8AEE3ED4@BGSMSX101.gar.corp.intel.com>
References: <20170712075846.14834-1-zhiyong.yang@intel.com>
 <20170804052753.35535-1-zhiyong.yang@intel.com>
 <61ed8dc6-99f1-cfb5-a560-ac4d2f0a6657@intel.com>
 <E182254E98A5DA4EB1E657AC7CB9BD2A8AEE3C82@BGSMSX101.gar.corp.intel.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Cc: "Tan, Jianfeng" <jianfeng.tan@intel.com>, "yliu@fridaylinux.org"
 <yliu@fridaylinux.org>, "jerin.jacob@caviumnetworks.com"
 <jerin.jacob@caviumnetworks.com>, "thomas@monjalon.net" <thomas@monjalon.net>
To: "Yang, Zhiyong" <zhiyong.yang@intel.com>, "Horton, Remy"
 <remy.horton@intel.com>, "dev@dpdk.org" <dev@dpdk.org>
Return-path: <dev-bounces@dpdk.org>
Received: from mga05.intel.com (mga05.intel.com [192.55.52.43])
 by dpdk.org (Postfix) with ESMTP id 9EDE93772
 for <dev@dpdk.org>; Mon,  7 Aug 2017 05:07:30 +0200 (CEST)
In-Reply-To: <E182254E98A5DA4EB1E657AC7CB9BD2A8AEE3C82@BGSMSX101.gar.corp.intel.com>
Content-Language: en-US
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <http://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: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>

Hi, Thomas:
	Need I sent another V3 patch to update commit log according to Remy's sugg=
estion?
Thanks
Zhiyong

> -----Original Message-----
> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Yang, Zhiyong
> Sent: Saturday, August 5, 2017 6:35 PM
> To: Horton, Remy <remy.horton@intel.com>; dev@dpdk.org
> Cc: Tan, Jianfeng <jianfeng.tan@intel.com>; yliu@fridaylinux.org;
> jerin.jacob@caviumnetworks.com; thomas@monjalon.net
> Subject: Re: [dpdk-dev] [PATCH v2] doc: announce API and ABI change for
> ethdev
>=20
> Hi, Remy:
>=20
> > -----Original Message-----
> > From: Horton, Remy
> > Sent: Friday, August 4, 2017 2:56 PM
> > To: Yang, Zhiyong <zhiyong.yang@intel.com>; dev@dpdk.org
> > Cc: Tan, Jianfeng <jianfeng.tan@intel.com>; yliu@fridaylinux.org;
> > jerin.jacob@caviumnetworks.com; thomas@monjalon.net
> > Subject: Re: [dpdk-dev] [PATCH v2] doc: announce API and ABI change
> > for ethdev
> >
> >
> > On 04/08/2017 06:27, Zhiyong Yang wrote:
> > > This is an API/ABI change notice for DPDK 17.11 on redefinition of
> > > port_id. port_id is defined as uint8_t by now, which is just ranged
> > > from 0 to 255. For more and more scenerioes, more than 256 ports are
> > > needed to support for vdev scalability.
> > >
> > > It is necessary for redefinition of port_id to extend from 1 bytes
> > > to
> > > 2 bytes. All ethdev APIs and use cases related to port_id will be
> > > changed at the same time.
> >
> > I think this reads a little better:
> >
> > This is an API/ABI change notice for DPDK 17.11 announcing the
> > redefinition of port_id. port_id is currently defined as uint8_t,
> > which is limited to the range 0 to 255. A larger range is required for =
vdev
> scalability.
> >
> > It is necessary for a redefinition of port_id to extend it from 1 bytes=
 to 2 bytes.
> > All ethdev APIs and usages related to port_id will be changed at the sa=
me time.
>=20
> Thanks Remy, of course. Your statement is better. I have a lot of things =
 to learn
> when speaking in English. I hope I can describe things like you, a native
> speaker. :) Thanks again for your ack.
>=20
> Zhiyong
>=20
> >
> > >  doc/guides/rel_notes/deprecation.rst | 6 ++++++
> > >  1 file changed, 6 insertions(+)
> >
> > Acked-by: Remy Horton <remy.horton@intel.com>