[dpdk-dev] doc: announce ABI changes for user-owned mempool caches

Message ID 1459848188-30028-1-git-send-email-l@nofutznetworks.com (mailing list archive)
State Accepted, archived
Headers

Commit Message

Lazaros Koromilas April 5, 2016, 9:23 a.m. UTC
  Deprecation notice for 16.04 for changes targeting release 16.07.
The changes affect struct rte_mempool, rte_mempool_cache and the
mempool API.

Signed-off-by: Lazaros Koromilas <l@nofutznetworks.com>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
  

Comments

Olivier Matz April 5, 2016, 3:42 p.m. UTC | #1
On 04/05/2016 11:23 AM, Lazaros Koromilas wrote:
> Deprecation notice for 16.04 for changes targeting release 16.07.
> The changes affect struct rte_mempool, rte_mempool_cache and the
> mempool API.
> 
> Signed-off-by: Lazaros Koromilas <l@nofutznetworks.com>

Acked-by: Olivier Matz <olivier.matz@6wind.com>
  
Hunt, David April 8, 2016, 2:01 p.m. UTC | #2
On 4/5/2016 4:42 PM, Olivier Matz wrote:
> On 04/05/2016 11:23 AM, Lazaros Koromilas wrote:
>> Deprecation notice for 16.04 for changes targeting release 16.07.
>> The changes affect struct rte_mempool, rte_mempool_cache and the
>> mempool API.
>>
>> Signed-off-by: Lazaros Koromilas <l@nofutznetworks.com>
> Acked-by: Olivier Matz <olivier.matz@6wind.com>
>

Acked-by: David Hunt<david.hunt@intel.com>
  
Thomas Monjalon April 10, 2016, 9:55 a.m. UTC | #3
> >> Deprecation notice for 16.04 for changes targeting release 16.07.
> >> The changes affect struct rte_mempool, rte_mempool_cache and the
> >> mempool API.
> >>
> >> Signed-off-by: Lazaros Koromilas <l@nofutznetworks.com>
> > Acked-by: Olivier Matz <olivier.matz@6wind.com>
> Acked-by: David Hunt<david.hunt@intel.com>

It is the fourth change announced for rte_mempool in 16.07.

Applied, thanks
  

Patch

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index ad31355..6ccabcb 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -40,3 +40,10 @@  Deprecation Notices
   The existing API will be backward compatible, but there will be new API
   functions added to facilitate the creation of mempools using an external
   handler. The 16.07 release will contain these changes.
+
+* ABI change for rte_mempool struct to move the cache-related fields
+  to the more appropriate rte_mempool_cache struct. The mempool API is
+  also changed to enable external cache management that is not tied to EAL
+  threads. Some mempool get and put calls are removed in favor of a more
+  compact API. The ones that remain are backwards compatible and use the
+  per-lcore default cache if available. This change targets release 16.07.