From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from NAM03-BY2-obe.outbound.protection.outlook.com (mail-by2nam03on0088.outbound.protection.outlook.com [104.47.42.88]) by dpdk.org (Postfix) with ESMTP id A9E5B9E7 for ; Tue, 14 Feb 2017 04:25:39 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=CAVIUMNETWORKS.onmicrosoft.com; s=selector1-cavium-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=1mq6Ajh/HogcNbEmQXaXe5QIHjtqeEC2sqcWDDDqpGE=; b=VfXwZMAg+MBonNZIcWW4RyzXoPxK7Jtow9rxX2cnm64trYaHBZGsJbyDos2ha82j0XDNLNj8yb8pLTd24AaDNHER/5riQNuXHhtCFGXhbzGA9IUK3f7+ELvQjTa2x3ZCFkh/EKbls3irxOiM+Vp/XLYa2BXE4wfGurjssaeQoM8= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=Jerin.Jacob@cavium.com; Received: from localhost.localdomain (111.93.218.67) by BLUPR0701MB1714.namprd07.prod.outlook.com (10.163.85.140) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.888.16; Tue, 14 Feb 2017 03:25:36 +0000 Date: Tue, 14 Feb 2017 08:55:21 +0530 From: Jerin Jacob To: Bruce Richardson Cc: dev@dpdk.org Message-ID: <20170214032520.GE3131@localhost.localdomain> References: <1487007510-710-1-git-send-email-bruce.richardson@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1487007510-710-1-git-send-email-bruce.richardson@intel.com> User-Agent: Mutt/1.7.1 (2016-10-04) X-Originating-IP: [111.93.218.67] X-ClientProxiedBy: MA1PR01CA0012.INDPRD01.PROD.OUTLOOK.COM (10.164.117.19) To BLUPR0701MB1714.namprd07.prod.outlook.com (10.163.85.140) X-MS-Office365-Filtering-Correlation-Id: 2aa065dc-4b9a-40d2-a413-08d454892539 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:BLUPR0701MB1714; X-Microsoft-Exchange-Diagnostics: 1; BLUPR0701MB1714; 3:OboYgodxcHmPvXFag7RZxhYHZm8Yxm+MAv7UjA6U3XLIuAJ87P9e1HVU1ols21exu4QzFuGnE9d2rmXUangEBtZx1JoQDTXJ7AIN9BwWzq+0i4oImK7vf3CEagxaQ43CrgaKNDckTXJa8WcdnM+BKhYD1GW75EES93qbQD1sRvMyOVsYJDZdZi8PTBp0/2mCJomzU5bqimgH5xlT+kiuCyItlpog7pa986vkNcj6xK7YEBprcuLZgIeOEiH1dcIArK50qg5mkl89879VviH5sw==; 25:Y+WORQk4bVi5tPS+DKb/51mCbba2Sgk+PxePNitHUjgwgFu3npZ8z4wUS2wUP+MwTCrSFRv09aMCsh71rq+/7QXcp/B55qciPEbUbM1wuaSAtr1kb5P0iZhmeqku4hnlZZY0EAz5KjaGgH3E37fjg51kGzaite5XxfbeuWnVLRAVjOcCvE1IP0iF+Bon9KdgjnJzf0H7nV64aDGOsDGZSs2OI7eKVZq6/Atgxc1xffeBF0UFG+aPH2WRIjm75uu0nNkyeJajsjHtDy/V6LoHDjVBlVyhtaIdnxWrwJ7VgqrkS1l+4G7flSU1LS6y4vTJOlHHoqdfOVVUrXXv+vO7DQ9977nC9SqdvERhHTgfewaEDIW0haS6kjLdN16wQBBA2UNHHLVie4V8FjNNTbGuB8WOs01eRyoA/xHo54Fb4iWdGxOLl8JD1sjI30mQ4l9hKYNV0JD2BfkLMppHE5/jIg== X-Microsoft-Exchange-Diagnostics: 1; BLUPR0701MB1714; 31:jOIjHV/MOn7nrAvkQHanGBRE58/0IONRqXQdBBAuVf2F1zVax8Jz1GVkTj/wHOlfgHhAQrM4CGlIybm+IR9Maxc9JjWuuBu9MS5OYaeZ4oJWsHXl9RwGws8+2SBsufdIauwIa1+NnzMF6kUhAtNyeIuiAIqNJS1+w52no2d2u21zCzo8tGvhc3jYxGFrvw/KAeWlO8mlSoiL7gu416d0ABoyCKHxzAfWyZ4fXzIFtI90F69G7ArjJB8VNqAHVBkDmNdMjqkNSAKY60LnBS1lGOpnkbSEnhTKssTJcAcGnoY=; 20:k8ixHnUsOpZsYCxofcBnQ8YeRx0WVmcjfKKfkovSo/QAvu4cyFf58gryXpRgg1gnS0bcctnJI39MRsajnXUYplm3V1yOCTiZTAJVAJaFBQmqK/fWQEnnjgLE4ThB2J+uvp4OjKLw9uc83X/jRZxrkdLHBV7HhNMiJVAz2To7D61mMpAhB9EOM+8cHZI0zyy+N00uYU7z9zWvuFwuMxhIRiRayJfES6wQWntwE8S6snzV0572hAic/OMLHYVwD3IzohK5zz5HL+mqUnylSWJH9IlfkOnum2DLCiG4E29I396kA70d5zcBPB5IpPmKFVNF4i6CkMVdedjfdEPvdUeqSR6bbNWxI4hpPnA8T8gi887NfWyLbvuE2FYgg9j7AUBGebyelZgUVzsli6N8smzF6NUIETcxGmzB/2C8bdTdj2Zrr+S/tGuvKOuqrtD3R5eit3A0adjk4cOEReZn0ncVEzE9JlK25XnZ2FANCi4/KzVLPUwfcglAdHPVNqpegBBLtWMSXnl7gTwVNDtucGZxNGTXOLeMtTzwsL/WaoxNVAzWlN4a8FYmtEvrGtkKmUB3fCdAv5paliTy1fHy3YiaPAAccf4bpRqeZCB9xvK/iRM= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(131327999870524)(228905959029699); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040375)(601004)(2401047)(5005006)(8121501046)(3002001)(10201501046)(6041248)(20161123564025)(20161123562025)(20161123560025)(20161123555025)(20161123558025)(6072148); SRVR:BLUPR0701MB1714; BCL:0; PCL:0; RULEID:; SRVR:BLUPR0701MB1714; X-Microsoft-Exchange-Diagnostics: 1; BLUPR0701MB1714; 4:Hxi9szKk3ZLLY8K7BLrnEU4Ed2Zvw+qU2GjeBtVW13I6JG0weOesoblP7vLJO1T17noCrsnt/med+sRJatJyR40uHWgz4h2IlWZiAaeJ73NeXGiMp4oE8QhLeong3vOs4bU1bWesUWHzeX6eLOkPiUR47q/1wQ7LUBi8k/LHYfgqBxUyUhxVXe5BAoNnhm/K9J379DvmFhrtqNggtnNPGtR9jvNSMF952PQdyPvzYQnU8/ZREq4A3KTc1tO5kg/jTl+GR0043SUK07qAQOqSPXYQK7ah7LU98xhnT6j1huX9L5ACv3aFr76ngulRw2WZnu+SWUSZnwdHOyN35w5OG/HuAFvSSlOyadCuawiXLKJNWCt4yFpHLGz7k+7u6CyJJ0dpaPnhtgkVwZtxqBESIFzBDScyE0L+cLaH3G5YWjjoTXxwRcosZfJYUXpTpup/To6yIKG4hC5h71kyTlk00DK4H1HbEKlNtmjToYmK51h2+mckESscKvWcTkeWG1S7eK1jU95MZZ3Y7pUka4ypseNp4GLGZNPa3I1dHazW+TnUKhDEe0MZX7jxh3Qd8RZlfu00JaroRBH4kOujcQ2HIR+5Ow6HzutnGljL94afQsNN7xkwlpS5muaOtehYfcS4DK0omlQYRau78LXEeSkN4428Kb6yE+QElbnxEWfcwztxYPTcKCisVfNH7xSaLTHI X-Forefront-PRVS: 0218A015FA X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(6069001)(7916002)(39450400003)(199003)(24454002)(189002)(50466002)(47776003)(6246003)(1076002)(15650500001)(66066001)(6116002)(38730400002)(3846002)(61506002)(53936002)(83506001)(42882006)(2950100002)(92566002)(6916009)(33656002)(68736007)(97736004)(6666003)(25786008)(55016002)(6506006)(9686003)(229853002)(4001350100001)(575784001)(54356999)(101416001)(189998001)(23726003)(5009440100003)(105586002)(50986999)(76176999)(110136004)(106356001)(5660300001)(305945005)(2906002)(7736002)(81166006)(8676002)(81156014)(81003)(42186005)(7099028)(18370500001); DIR:OUT; SFP:1101; SCL:1; SRVR:BLUPR0701MB1714; H:localhost.localdomain; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX:1; LANG:en; Received-SPF: None (protection.outlook.com: cavium.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BLUPR0701MB1714; 23:F1q7mWPti/4YuvnQVOVSDgjqoQvUr5I68kdBUrF?= =?us-ascii?Q?JRO5fTll+ugj0AwnSwfX81c6jvO1Gk19R70t0ItbnIOdJUmtO6q10qpeJOsD?= =?us-ascii?Q?X7tG8ijHFe6qDoROY1h3aBBBP/UHQMuvk6gRrUmtvZmBDqCpBBQaiXQzgH1S?= =?us-ascii?Q?hQdLvN8EjAo1leXxcNRqYK6mOJP+TohuCcZpEzNnDZ6aBFRcWSZAQmYvpUfT?= =?us-ascii?Q?+SfDoG8OeUly0/341Wzu2o35EY7Q/UQf8vbuX/FgXFWY3p7WSomhIxr1+3uF?= =?us-ascii?Q?xYPUEuwEkpqP6bh51xjJo3MVRZ03gGmFSfMbFDnk+5V+mhB9Ja2Yw7pyOnEt?= =?us-ascii?Q?ttV33uZeN+lni6q3JBj0u4CxBlhLmEUzX62w90//BqLkMGUvfazxC5WkE8cv?= =?us-ascii?Q?/bUUFciLbyrCR3ixFt/qzus/lA8eibQDVSd3OZvA564sbdnSCaYEouV3CZZs?= =?us-ascii?Q?sQ6DnrqnpW4SUgr/08ERrA8P0uJkqx0rbRSEzbtEb6zfntawN/693MxN9fcS?= =?us-ascii?Q?XtWQZr6ti8z1dZ+UaEQcGyHJJNwS3cA4wP8zz/cSH4N3qNo4Hl92DdIQeFf9?= =?us-ascii?Q?ntOtbAvsbgcNy5AZE0s1qkO9EJqVrthxwT+pvnUGpWGIvgkx2vVV/+Kipisy?= =?us-ascii?Q?xyZz714glQiHXmgmsuu9Pfi5s7qwcL4LUvHmEk/CnEZEnFvGQIy2OO1PRc7V?= =?us-ascii?Q?ETagv+3bBfVMLvKrq3M47XHmL+NnIqCxomzJYHE7hvcByXerTfVfdx7Uf3Ak?= =?us-ascii?Q?PEtCzyoMDz6hJVQ7hzeDTfMBgXPobPfXu0UWA8KDwravIIC3/N83i4lcos/l?= =?us-ascii?Q?BPpz9tvIcNOpKNUD0IlwvL9AHE4mvzlayluJLt2gVuRcfxsi68iBlIPMWqcw?= =?us-ascii?Q?9s12Ly2S/L+xUZ/I4/A3pyJma9ctiXgWOTt0NF2dLc1vlEUAebmqPWiIK8bs?= =?us-ascii?Q?aRRx581YnBNncjO7JPpc5G5uaKJLygZgqd8yJdSQ/73KigjQgxYKrJ+90MYC?= =?us-ascii?Q?sD+Ze1ZOBjCoeBdD5OAIg4ifPJ24/9rzxuWI71gmfnixb/ZC/xhaYhCJQARc?= =?us-ascii?Q?kJSUrsvRHGtqv8dhTaRhfc5uFIam2JAu/S42TF4pDxU5cQDDH3bCMrm+Cxrz?= =?us-ascii?Q?wrtBCvSIKXkWn4pM2RPHwf3csSYL0YZ69wDZAr+1cio2unxl6IwI1Jt0YyZo?= =?us-ascii?Q?BjcqL++BqmbNc7oTDjpvJVyt7pX0KZLjP6fna9/O0dlgX7nr7eNxTOAZI6HL?= =?us-ascii?Q?a0+6jS7aORFIFbf0vVDDFbe7Zohhtti9nzJMIiE7qb+pM2C1CtClotrX9tl+?= =?us-ascii?Q?sW0faA2gc4s93y3mBopZ/dBdIXx+DGGXdDeA4SJ7qoh1JRi2S5mMDmWMNccK?= =?us-ascii?Q?3H1qadg=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; BLUPR0701MB1714; 6:XvuIEBmwp3hSST/WSZgx4rbPA1GxgNsp2gPIkjDfg+Z5+tHQdt3nO4JlSi4iQR9WcT7EOqYRJw1IHl+WR1wECBjdicWx/2VrUI+mLtT9XVQFel2/rio7FUBwgx0Z0rPPZVDolF1yePX99RJVRhlhurHLrORq25rQeApUjGigO+fOSy/9U8MdHf0pfsv3vFM3SpzgdnM3xa2v7i24b7U42z25z5vRlD2MUBIKM+BgQ6wtT7GI+3AHR2LZ94XZ6bYtWlIueDd7JjYg++R5Po1jmz9nZtnrVr6IV+VQua9OYUx8ou/oLWEO+PvfyT4V1I6t4JTXiz/Uw9cxhF362Zx6CVHTg53g70tssJ4RcxxC5rnaljCugElpxVhRmLjKcaXRZmtQiTfGPt8a5o2FlKTZgg==; 5:33FR5ZKoWI9A5FmBDvyuW7zqpCJ6+7Fwbniqi7QrRIT/7HynbRujQXGHXzV+wJyuh9BbTLF+Rfjvqlo1MmZn5bEvgJNoA75ygByeGdNMG1NGqt+fiN/rr1vxt1Xs+HqByBZxS9vv6cI/OQZfETVQbw==; 24:d13QW95RslyKXOV0kp7DqKzlqk3EIJsfZ4c+jBzUxbXMrY5PsVcrW56PFs5g7RBZ1bWOY2ZKAN7JJdGDOGf1/VsL2MG1gFMftjTKP2LvXRU= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BLUPR0701MB1714; 7:jpOypXxx4gE0pa4mMdO4mmjFkRTzRbEiQi3MdP60C6APAX7Zy7IZOjXUBTeQa4NRMQ5QhsU8YLGERFrxj9GJJzBpTfQoddt3S3cn3yPUxMEBh5Ff/eBBHd6+0X3s1a4v+FFi5AFc6+geUdLmkIca0SYR2kTPaFwwGaDWJ1PZhhDkE153t+EHqt1dtEvlUnkzEnDQ5n3GxLYQEyJ+n5XFyyFfBzaTMOtNBp1dPpW3TmQ5mYS1lbaEa8adhKVyMnBQWS8bWuWqcyXUbF+HFa+d85cQqm7B+f7JLTxuWSwX9VsVjq3L4Px7RtyCEuv8+lIP7ykcw7zLN9DBRBqIkNZT1pO+og7MDowVn7+fJvkHzulNsGdG8KnqhrPZfkp1eixxeCvQmcHDBX/ItHt/qNTxQvhRBfNWX8MEtyPYiEymouqVYnOSU3bGALiqGXvnjN7P4xkGXTz5/Liry5QI16RM+xeOLfpP6GqWw0zL93LDix76k/64gEDy8iTBKxXcWgdw0ah20sQMrpDxaNH6nu7HIA== X-OriginatorOrg: caviumnetworks.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Feb 2017 03:25:36.7250 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: BLUPR0701MB1714 Subject: Re: [dpdk-dev] [PATCH] doc: add ABI change notification for ring library 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, 14 Feb 2017 03:25:40 -0000 On Mon, Feb 13, 2017 at 05:38:30PM +0000, Bruce Richardson wrote: > Document proposed changes for the rings code in the next release. > > Signed-off-by: Bruce Richardson > --- > doc/guides/rel_notes/deprecation.rst | 19 +++++++++++++++++++ > 1 file changed, 19 insertions(+) > > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst > index b49e0a0..e715fc7 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -8,6 +8,25 @@ API and ABI deprecation notices are to be posted here. > Deprecation Notices > ------------------- > > +* ring: Changes are planned to rte_ring APIs in release 17.05. Proposed > + changes include: > + - Removing build time options for the ring: > + CONFIG_RTE_RING_SPLIT_PROD_CONS > + CONFIG_RTE_RING_PAUSE_REP_COUNT > + - Adding an additional parameter to enqueue functions to return the > + amount of free space in the ring > + - Adding an additional parameter to dequeue functions to return the > + number of remaining elements in the ring > + - Removing direct support for watermarks in the rings, since the > + additional return value from the enqueue function makes it > + unneeded > + - Adjusting the return values of the bulk() enq/deq functions to > + make them consistent with the burst() equivalents. [Note, parameter > + to these functions are changing too, per points above, so compiler > + will flag them as needing update in legacy code] > + - Updates to some library functions e.g. rte_ring_get_memsize() to > + allow for variably-sized ring elements. > + > * igb_uio: iomem mapping and sysfs files created for iomem and ioport in > igb_uio will be removed, because we are able to detect these from what Linux > has exposed, like the way we have done with uio-pci-generic. This change Acked-by: Jerin Jacob