1 ABI and API Deprecation
2 =======================
4 See the :doc:`guidelines document for details of the ABI policy </contributing/versioning>`.
5 API and ABI deprecation notices are to be posted here.
11 * The log history is deprecated.
12 It is voided in 16.07 and will be removed in release 16.11.
14 * The ethdev hotplug API is going to be moved to EAL with a notification
15 mechanism added to crypto and ethdev libraries so that hotplug is now
16 available to both of them. This API will be stripped of the device arguments
17 so that it only cares about hotplugging.
19 * Structures embodying pci and vdev devices are going to be reworked to
20 integrate new common rte_device / rte_driver objects (see
21 http://dpdk.org/ml/archives/dev/2016-January/031390.html).
22 ethdev and crypto libraries will then only handle those objects so that they
23 do not need to care about the kind of devices that are being used, making it
24 easier to add new buses later.
26 * ABI changes are planned for adding four new flow types. This impacts
27 RTE_ETH_FLOW_MAX. The release 2.2 does not contain these ABI changes,
28 but release 2.3 will. [postponed]
30 * ABI will change for rte_mempool struct to move the cache-related fields
31 to the more appropriate rte_mempool_cache struct. The mempool API is
32 also changed to enable external cache management that is not tied to EAL
33 threads. Some mempool get and put calls are removed in favor of a more
34 compact API. The ones that remain are backwards compatible and use the
35 per-lcore default cache if available. This change targets release 16.07.
37 * The rte_mempool struct will be changed in 16.07 to facilitate the new
38 external mempool manager functionality.
39 The ring element will be replaced with a more generic 'pool' opaque pointer
40 to allow new mempool handlers to use their own user-defined mempool
41 layout. Also newly added to rte_mempool is a handler index.
42 The existing API will be backward compatible, but there will be new API
43 functions added to facilitate the creation of mempools using an external
44 handler. The 16.07 release will contain these changes.
46 * A librte_vhost public structures refactor is planned for DPDK 16.07
47 that requires both ABI and API change.
48 The proposed refactor would expose DPDK vhost dev to applications as
49 a handle, like the way kernel exposes an fd to user for locating a
50 specific file, and to keep all major structures internally, so that
51 we are likely to be free from ABI violations in future.
53 * The mbuf flags PKT_RX_VLAN_PKT and PKT_RX_QINQ_PKT are deprecated and
54 are respectively replaced by PKT_RX_VLAN_STRIPPED and
55 PKT_RX_QINQ_STRIPPED, that are better described. The old flags and
56 their behavior will be kept in 16.07 and will be removed in 16.11.