From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by dpdk.org (Postfix) with ESMTP id 4C6CB37AF for ; Sat, 5 Aug 2017 12:34:44 +0200 (CEST) Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 05 Aug 2017 03:34:43 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.41,325,1498546800"; d="scan'208";a="1179283194" Received: from fmsmsx104.amr.corp.intel.com ([10.18.124.202]) by fmsmga001.fm.intel.com with ESMTP; 05 Aug 2017 03:34:43 -0700 Received: from fmsmsx114.amr.corp.intel.com (10.18.116.8) by fmsmsx104.amr.corp.intel.com (10.18.124.202) with Microsoft SMTP Server (TLS) id 14.3.319.2; Sat, 5 Aug 2017 03:34:43 -0700 Received: from bgsmsx105.gar.corp.intel.com (10.223.43.197) by FMSMSX114.amr.corp.intel.com (10.18.116.8) with Microsoft SMTP Server (TLS) id 14.3.319.2; Sat, 5 Aug 2017 03:34:43 -0700 Received: from bgsmsx101.gar.corp.intel.com ([169.254.1.180]) by BGSMSX105.gar.corp.intel.com ([169.254.3.174]) with mapi id 14.03.0319.002; Sat, 5 Aug 2017 16:04:40 +0530 From: "Yang, Zhiyong" To: "Horton, Remy" , "dev@dpdk.org" CC: "Tan, Jianfeng" , "yliu@fridaylinux.org" , "jerin.jacob@caviumnetworks.com" , "thomas@monjalon.net" Thread-Topic: [dpdk-dev] [PATCH v2] doc: announce API and ABI change for ethdev Thread-Index: AQHTDOK2tQ2FPg+vqkyXXW5g/cyQvqJzZ5IAgAIpI1A= Date: Sat, 5 Aug 2017 10:34:40 +0000 Message-ID: References: <20170712075846.14834-1-zhiyong.yang@intel.com> <20170804052753.35535-1-zhiyong.yang@intel.com> <61ed8dc6-99f1-cfb5-a560-ac4d2f0a6657@intel.com> In-Reply-To: <61ed8dc6-99f1-cfb5-a560-ac4d2f0a6657@intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiZWFkMDBmYWQtNmNiOS00NmRiLWJlYjYtNjYzNDIyMjE3ZDYxIiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX0lDIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE2LjUuOS4zIiwiVHJ1c3RlZExhYmVsSGFzaCI6Ino4bFZPZk1FcVpDOXpzR2s4WUFrZ1dGWnFFU2FOSjJtSFA5SGdqQ1N4NDA9In0= x-ctpclassification: CTP_IC dlp-product: dlpe-windows dlp-version: 10.0.102.7 dlp-reaction: no-action x-originating-ip: [10.223.10.10] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCH v2] doc: announce API and ABI change for ethdev 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: Sat, 05 Aug 2017 10:34:45 -0000 Hi, Remy: > -----Original Message----- > From: Horton, Remy > Sent: Friday, August 4, 2017 2:56 PM > To: Yang, Zhiyong ; dev@dpdk.org > Cc: Tan, Jianfeng ; 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 >=20 > 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. >=20 > I think this reads a little better: >=20 > This is an API/ABI change notice for DPDK 17.11 announcing the redefiniti= on 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. >=20 > It is necessary for a redefinition of port_id to extend it from 1 bytes t= o 2 bytes. > All ethdev APIs and usages related to port_id will be changed at the same= time. Thanks Remy, of course. Your statement is better. I have a lot of things t= o learn when speaking in English. I hope I can describe things like you, a native s= peaker. :) Thanks again for your ack. =20 Zhiyong >=20 > > doc/guides/rel_notes/deprecation.rst | 6 ++++++ > > 1 file changed, 6 insertions(+) >=20 > Acked-by: Remy Horton