From fcd5106cf14833892cd96412179987ad9ee437ba Mon Sep 17 00:00:00 2001 From: Lazaros Koromilas Date: Tue, 5 Apr 2016 12:23:08 +0300 Subject: [PATCH] doc: announce ABI changes for user-owned mempool caches 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 Acked-by: Olivier Matz Acked-by: David Hunt --- doc/guides/rel_notes/deprecation.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 4bdde69812..191307d37e 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -43,6 +43,13 @@ Deprecation Notices The rte_mempool.local_cache will be converted from an array to a pointer to allow for dynamic allocation of the per lcore cache memory. +* ABI will 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. + * The rte_mempool struct will be changed in 16.07 to facilitate the new external mempool manager functionality. The ring element will be replaced with a more generic 'pool' opaque pointer -- 2.20.1