From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR01-DB5-obe.outbound.protection.outlook.com (mail-db5eur01on0047.outbound.protection.outlook.com [104.47.2.47]) by dpdk.org (Postfix) with ESMTP id 361412C4F for ; Mon, 7 Aug 2017 17:20:09 +0200 (CEST) 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=QesVxM+sbYYOrXdX+YJzKUkY64t5vo5j59FIM1U5Tsk=; b=r0ZgT5O4qgaTZr5W701U+P6JnnpyCM8Rt37jB1FGKMQMaCgHAxM+eW+EB1EY9/rst3FHzh2aVNDkoWpo8gnSUY959l/TdM+5BDTsc6Xlh7y2p8xZo7d9b+PMahDMT7JfCFdQttZt0L4EX751z/t8GBOqHFf+K1Vqct+Iuerc6SQ= Received: from VI1PR05MB3149.eurprd05.prod.outlook.com (10.170.237.142) by VI1PR05MB3149.eurprd05.prod.outlook.com (10.170.237.142) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.1.1304.22; Mon, 7 Aug 2017 15:20:07 +0000 Received: from VI1PR05MB3149.eurprd05.prod.outlook.com ([fe80::48b5:a81d:6b63:b78e]) by VI1PR05MB3149.eurprd05.prod.outlook.com ([fe80::48b5:a81d:6b63:b78e%13]) with mapi id 15.01.1304.025; Mon, 7 Aug 2017 15:20:07 +0000 From: Shahaf Shuler To: Remy Horton , Zhiyong Yang , "dev@dpdk.org" CC: "jianfeng.tan@intel.com" , "yliu@fridaylinux.org" , "jerin.jacob@caviumnetworks.com" , Thomas Monjalon Thread-Topic: [dpdk-dev] [PATCH v2] doc: announce API and ABI change for ethdev Thread-Index: AQHTDO7P1VuFwS/JJ0S+VlGR/o8ZIKJ5Bzmw Date: Mon, 7 Aug 2017 15:20:07 +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: authentication-results: spf=none (sender IP is ) smtp.mailfrom=shahafs@mellanox.com; x-originating-ip: [193.47.165.251] x-ms-publictraffictype: Email x-microsoft-exchange-diagnostics: 1; VI1PR05MB3149; 6:vYI2NeC957aQpfv/VZQmt/ytyR2z6QzOZC17TPvpytEqcdZEjiwUQSP5HxevxXj5p1qzFfYisw2wQOIqIjHPcmZiT4o/UeUemiQl1u1o9gvFKIqGnSKHEhkZ5Ka/AiElGwLsjznkiywO4j3NkFdsVDlbdqugFoQEh90skMaNpC87M3RI/wfDGkuCwNe2WBBfkbXhwSE9jFMrzETzFLclqKvlFLO6wrri3ToDOoUk8O9axsIYwfXSR9XKmqSJr+4Pj9CwS4loWGPaFzEGLIQTrpIHQlYawIf6eDeZla6NOuX+9+lSGOUUdfdzL+huulF9sCRqpgVKtaTRHQKC/onCYg==; 5:iMsy4ZXjw+5IkLXeGM8x+MIvvrCEPFazw3f6H6U5M+jV0BtC6Pd8RX16+6BsirsctnNsG98rET37LrZQ6GH+rYaur51YmxhE5Z3oCgYEWX5O1LWY5Rk8AghAv97ntQztFrfP3g0dVVbOSjLc68T16A==; 24:JsYUjOrrztTByXXkjR5LCEEWNLw0l3SN8p1SqJKfXe9Ohe8c4nEiER0neg/XRc3iVMr0AkV1mTomPzZps1wufkK/llQlUEHJahELjxJIiNc=; 7:MQUkjFR4QfLO3vQDPHuspBl18P7PVFtuJOdKeYHh14mDzwknTEHDXuE5vnF1pJzjjwdnrIwwZbSsJaTjk8hta/nOC6pmftPcfPuuIC0fWED8nR6e+Lt5M9wcK12a6yUKB5Fs/AzK2hDKIozjx8soNS4U59CKEWLM1MrwnlBaNP3g1cnMC3z1226/Z8aE4W2/qoIn8mFjULIteAphThtOXPmrrhmlVhloLdBSsHDs0v4= x-ld-processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr x-ms-office365-filtering-correlation-id: 20b6b461-d37d-4455-619a-08d4dda7c96a x-ms-office365-filtering-ht: Tenant x-microsoft-antispam: UriScan:; BCL:0; PCL:0; RULEID:(300000500095)(300135000095)(300000501095)(300135300095)(22001)(300000502095)(300135100095)(2017030254152)(48565401081)(300000503095)(300135400095)(2017052603031)(201703131423075)(201703031133081)(201702281549075)(300000504095)(300135200095)(300000505095)(300135600095)(300000506095)(300135500095); SRVR:VI1PR05MB3149; x-ms-traffictypediagnostic: VI1PR05MB3149: x-exchange-antispam-report-test: UriScan:(228905959029699); x-microsoft-antispam-prvs: x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(601004)(2401047)(5005006)(8121501046)(100000703101)(100105400095)(3002001)(10201501046)(93006095)(93001095)(6055026)(6041248)(20161123558100)(20161123555025)(20161123560025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123564025)(20161123562025)(6072148)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:VI1PR05MB3149; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:VI1PR05MB3149; x-forefront-prvs: 0392679D18 x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(6009001)(39450400003)(39410400002)(39840400002)(39860400002)(39850400002)(39400400002)(189002)(199003)(377454003)(24454002)(97736004)(7736002)(305945005)(7696004)(5660300001)(2900100001)(33656002)(74316002)(3280700002)(53546010)(106356001)(105586002)(68736007)(86362001)(2501003)(2906002)(66066001)(53936002)(81166006)(81156014)(25786009)(55016002)(5250100002)(3660700001)(8936002)(6246003)(2950100002)(38730400002)(478600001)(3846002)(102836003)(6116002)(229853002)(189998001)(6506006)(50986999)(54906002)(101416001)(99286003)(14454004)(54356999)(4326008)(6436002)(9686003)(76176999); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR05MB3149; H:VI1PR05MB3149.eurprd05.prod.outlook.com; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; received-spf: None (protection.outlook.com: mellanox.com does not designate permitted sender hosts) 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-originalarrivaltime: 07 Aug 2017 15:20:07.2832 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: a652971c-7d2e-4d9b-a6a4-d149256f461b X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR05MB3149 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: Mon, 07 Aug 2017 15:20:09 -0000 Friday, August 4, 2017 9:56 AM, Remy Horton: > 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 t= he > same time. >=20 > > doc/guides/rel_notes/deprecation.rst | 6 ++++++ > > 1 file changed, 6 insertions(+) >=20 > Acked-by: Remy Horton Acked-by: Shahaf Shuler