From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <l@nofutznetworks.com> Received: from mail-wm0-f44.google.com (mail-wm0-f44.google.com [74.125.82.44]) by dpdk.org (Postfix) with ESMTP id 2C6E3E6D for <dev@dpdk.org>; Tue, 5 Apr 2016 11:23:11 +0200 (CEST) Received: by mail-wm0-f44.google.com with SMTP id 20so13024862wmh.1 for <dev@dpdk.org>; Tue, 05 Apr 2016 02:23:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nofutznetworks-com.20150623.gappssmtp.com; s=20150623; h=from:to:subject:date:message-id; bh=W75qcL34kZKzAaEK3E0PuY+enMKuBx9lc39PuevvQQs=; b=YFtw3n5aOByitVYS1Xp6zF8j3ajlr4HbXEYz3HRq+i36dV6650DOymRkbCmX6rqQ9T QgTVUXQVv1cbRNzfiIoewoA4XuTKzF95MM2OTHY9DH9T6lZSCZEjQ84TbrfRu46/O2yy Vhy3IujIkOI1IWFYXVdoo7+pV770TgCXPgVt+3uLuaUFiOK6/CKYxT0F/VeXaJIzVkw6 xSTwxjP6v8yj+PDZS758x5uGCgZhzrERvmzTa1hStgr/F52sT4ucRtIfZsslcXjvxlPQ L5JtfYZ+bp1yVVJnX3+zvJewi8aOBfeut+JTn3JUVkxMjOFtiHgkMVgW82tQO6Vxjawx xi9w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:subject:date:message-id; bh=W75qcL34kZKzAaEK3E0PuY+enMKuBx9lc39PuevvQQs=; b=W5XEQC0HIdjFEeBMZRFH+8NSYGChP5lGzj+Gi7eaxq3UUk6/xnbhBm9R4HuYpVJIoV RJntzelklJzjds5fGNjn0tnqvLbW5qeyFdmwC9NmJysSqhTUC8x09wg6YJI+3B9eB8Qt QCEuJmxnQtwosNU2pVcMdfoNucTzzU8wvCIht/hUoLOwdPYY6NCh2kC6ARAIw3cg+RoS s8qoTq8Dvk3U0o27txk2vYmY+XxnPp/fJ1uJhpy/ymZIO5FMrFWIgMkgvl14Z5WKtM5F kMZdNmxs+d92fULGiqPBFp4PStzE+oXivMYOQ2YKEe/1clYltKmxdmvqdmnClHQY03MH K3iw== X-Gm-Message-State: AD7BkJLloesy2m/X+lKbdLCtwWl0QfhHyS9bvxTk/Pr/C81TlRhfaHdM0iTD3O0tQPi8/A== X-Received: by 10.28.172.194 with SMTP id v185mr16612894wme.21.1459848190990; Tue, 05 Apr 2016 02:23:10 -0700 (PDT) Received: from lap-3.nofutz.com (ppp089210182232.access.hol.gr. [89.210.182.232]) by smtp.gmail.com with ESMTPSA id e190sm18512014wma.15.2016.04.05.02.23.09 for <dev@dpdk.org> (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 05 Apr 2016 02:23:10 -0700 (PDT) From: Lazaros Koromilas <l@nofutznetworks.com> To: dev@dpdk.org Date: Tue, 5 Apr 2016 12:23:08 +0300 Message-Id: <1459848188-30028-1-git-send-email-l@nofutznetworks.com> X-Mailer: git-send-email 1.9.1 Subject: [dpdk-dev] [PATCH] doc: announce ABI changes for user-owned mempool caches X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK <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: Tue, 05 Apr 2016 09:23:11 -0000 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(+) 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. -- 1.9.1