From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <remy.horton@intel.com>
Received: from mga09.intel.com (mga09.intel.com [134.134.136.24])
 by dpdk.org (Postfix) with ESMTP id 3675B2C18
 for <dev@dpdk.org>; Fri,  4 Aug 2017 08:56:21 +0200 (CEST)
Received: from orsmga005.jf.intel.com ([10.7.209.41])
 by orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;
 03 Aug 2017 23:56:20 -0700
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.41,319,1498546800"; d="scan'208";a="133462311"
Received: from rhorton-mobl1.ger.corp.intel.com (HELO [163.33.230.181])
 ([163.33.230.181])
 by orsmga005.jf.intel.com with ESMTP; 03 Aug 2017 23:56:19 -0700
To: Zhiyong Yang <zhiyong.yang@intel.com>, dev@dpdk.org
References: <20170712075846.14834-1-zhiyong.yang@intel.com>
 <20170804052753.35535-1-zhiyong.yang@intel.com>
Cc: jianfeng.tan@intel.com, yliu@fridaylinux.org,
 jerin.jacob@caviumnetworks.com, thomas@monjalon.net
From: Remy Horton <remy.horton@intel.com>
Organization: Intel Shannon Limited
Message-ID: <61ed8dc6-99f1-cfb5-a560-ac4d2f0a6657@intel.com>
Date: Fri, 4 Aug 2017 07:56:18 +0100
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:45.0) Gecko/20100101
 Thunderbird/45.7.1
MIME-Version: 1.0
In-Reply-To: <20170804052753.35535-1-zhiyong.yang@intel.com>
Content-Type: text/plain; charset=windows-1252; format=flowed
Content-Transfer-Encoding: 7bit
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 <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>
X-List-Received-Date: Fri, 04 Aug 2017 06:56:22 -0000


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 same time.

>  doc/guides/rel_notes/deprecation.rst | 6 ++++++
>  1 file changed, 6 insertions(+)

Acked-by: Remy Horton <remy.horton@intel.com>