@@ -1,33 +1,46 @@
.. SPDX-License-Identifier: BSD-3-Clause
- Copyright 2018 The DPDK contributors
+ Copyright 2019 The DPDK contributors
-.. abi_api_policy:
+.. _abi_policy:
-DPDK ABI/API policy
-===================
+ABI Policy
+==========
Description
-----------
-This document details some methods for handling ABI management in the DPDK.
+This document details the management policy that ensures the long-term stability
+of the DPDK ABI and API.
General Guidelines
------------------
-#. Whenever possible, ABI should be preserved
-#. ABI/API may be changed with a deprecation process
-#. The modification of symbols can generally be managed with versioning
-#. Libraries or APIs marked in ``experimental`` state may change without constraint
-#. New APIs will be marked as ``experimental`` for at least one release to allow
- any issues found by users of the new API to be fixed quickly
-#. The addition of symbols is generally not problematic
-#. The removal of symbols generally is an ABI break and requires bumping of the
- LIBABIVER macro
-#. Updates to the minimum hardware requirements, which drop support for hardware which
- was previously supported, should be treated as an ABI change.
-
-What is an ABI
-~~~~~~~~~~~~~~
+#. Major ABI versions are declared every **year** and are then supported for one
+ year, typically aligned with the :ref:`LTS release <stable_lts_releases>`.
+#. The ABI version is managed at a project level in DPDK, with the ABI version
+ reflected in all :ref:`library's soname <what_is_soname>`.
+#. The ABI should be preserved and not changed lightly. ABI changes must follow
+ the outlined :ref:`deprecation process <abi_changes>`.
+#. The addition of symbols is generally not problematic. The modification of
+ symbols is managed with :ref:`ABI Versioning <abi_versioning>`.
+#. The removal of symbols is considered an :ref:`ABI breakage <abi_breakages>`,
+ once approved these will form part of the next ABI version.
+#. Libraries or APIs marked as :ref:`Experimental <experimental_apis>` are not
+ considered part of an ABI version and may change without constraint.
+#. Updates to the :ref:`minimum hardware requirements <hw_rqmts>`, which drop
+ support for hardware which was previously supported, should be treated as an
+ ABI change.
+
+.. note::
+
+ In 2019, the DPDK community stated it's intention to move to ABI stable
+ releases, over a number of release cycles. Beginning with maintaining ABI
+ stability through one year of DPDK releases starting from DPDK 19.11. This
+ policy will be reviewed in 2020, with intention of lengthening the stability
+ period.
+
+What is an ABI?
+~~~~~~~~~~~~~~~
An ABI (Application Binary Interface) is the set of runtime interfaces exposed
by a library. It is similar to an API (Application Programming Interface) but
@@ -39,30 +52,73 @@ Therefore, in the case of dynamic linking, it is critical that an ABI is
preserved, or (when modified), done in such a way that the application is unable
to behave improperly or in an unexpected fashion.
+What is an ABI version?
+~~~~~~~~~~~~~~~~~~~~~~~
-ABI/API Deprecation
--------------------
+An ABI version is an instance of a library's ABI at a specific release. Certain
+releases are considered by the community to be milestone releases, the yearly
+LTS for example. Supporting those milestone release's ABI for some number of
+subsequent releases is desirable to facilitate application upgrade. Those ABI
+version's aligned with milestones release are therefore called 'ABI major
+versions' and are supported for some number of releases.
+
+More details on major ABI version can be found in the :ref:`ABI versioning
+<major_abi_versions>` guide.
The DPDK ABI policy
-~~~~~~~~~~~~~~~~~~~
+-------------------
+
+A major ABI version is declared every year, aligned with that year's LTS
+release, e.g. v19.11. This ABI version is then supported for one year by all
+subsequent releases within that time period, until the next LTS release, e.g.
+v20.11.
+
+At the declaration of a major ABI version, major version numbers encoded in
+libraries soname's are bumped to indicate the new version, with the minor
+version reset to ``0``. An example would be ``librte_eal.so.20.3`` would become
+``librte_eal.so.21.0``.
+
+The ABI may then change multiple times, without warning, between the last major
+ABI version increment and the HEAD label of the git tree, with the condition
+that ABI compatibility with the major ABI version is preserved and therefore
+soname's do not change.
+
+Minor versions are incremented to indicate the release of a new ABI compatible
+DPDK release, typically the DPDK quarterly releases. An example of this, might
+be that ``librte_eal.so.20.1`` would indicate the first ABI compatible DPDK
+release, following the declaration of the new major ABI version ``20``.
+
+ABI versions, are supported by each release until such time as the next major
+ABI version is declared. At that time, the deprecation of the previous major ABI
+version will be noted in the Release Notes with guidance on individual symbol
+depreciation and upgrade notes provided.
-ABI versions are set at the time of major release labeling, and the ABI may
-change multiple times, without warning, between the last release label and the
-HEAD label of the git tree.
+.. _figure_abi_stability_policy:
-ABI versions, once released, are available until such time as their
-deprecation has been noted in the Release Notes for at least one major release
-cycle. For example consider the case where the ABI for DPDK 2.0 has been
-shipped and then a decision is made to modify it during the development of
-DPDK 2.1. The decision will be recorded in the Release Notes for the DPDK 2.1
-release and the modification will be made available in the DPDK 2.2 release.
+.. figure:: img/abi_stability_policy.*
-ABI versions may be deprecated in whole or in part as needed by a given
-update.
+*Figure 1. Mapping of new ABI versions and ABI version compatibility to DPDK
+releases.*
-Some ABI changes may be too significant to reasonably maintain multiple
-versions. In those cases ABI's may be updated without backward compatibility
-being provided. The requirements for doing so are:
+.. _abi_changes:
+
+ABI Changes
+~~~~~~~~~~~
+
+The ABI may still change after the declaration of a major ABI version, that is
+new APIs may be still added or existing APIs may be modified.
+
+.. Warning::
+
+ Note that, this policy details the method by which the ABI may be changed,
+ with due regard to preserving compatibility and observing depreciation
+ notices. This process however should not be undertaken lightly, as a general
+ rule ABI stability is extremely important for downstream consumers of DPDK.
+ The ABI should only be changed for significant reasons, such as performance
+ enhancements. ABI breakages due to changes such as reorganizing public
+ structure fields for aesthetic or readability purposes should be avoided.
+
+The requirements for changing the ABI are:
#. At least 3 acknowledgments of the need to do so must be made on the
dpdk.org mailing list.
@@ -71,34 +127,119 @@ being provided. The requirements for doing so are:
no maintainer is available for the component, the tree/sub-tree maintainer
for that component must acknowledge the ABI change instead.
+ - The acknowledgment of a member of the technical board, as a delegate of the
+ `technical board <https://core.dpdk.org/techboard/>`_ acknowledging the
+ need for the ABI change, is also mandatory.
+
- It is also recommended that acknowledgments from different "areas of
interest" be sought for each deprecation, for example: from NIC vendors,
CPU vendors, end-users, etc.
-#. The changes (including an alternative map file) can be included with
- deprecation notice, in wrapped way by the ``RTE_NEXT_ABI`` option,
- to provide more details about oncoming changes.
- ``RTE_NEXT_ABI`` wrapper will be removed when it become the default ABI.
- More preferred way to provide this information is sending the feature
- as a separate patch and reference it in deprecation notice.
+#. Backward compatibility with the major ABI version must be maintained through
+ :ref:`abi_versioning`, with :ref:`forward-only <forward-only>` compatibility
+ offered for any ABI changes that are indicated to be part of the next ABI
+ version.
-#. A full deprecation cycle, as explained above, must be made to offer
- downstream consumers sufficient warning of the change.
+ - In situations where backward compatibility is not possible, read the
+ section on :ref:`abi_breakages`.
-Note that the above process for ABI deprecation should not be undertaken
-lightly. ABI stability is extremely important for downstream consumers of the
-DPDK, especially when distributed in shared object form. Every effort should
-be made to preserve the ABI whenever possible. The ABI should only be changed
-for significant reasons, such as performance enhancements. ABI breakage due to
-changes such as reorganizing public structure fields for aesthetic or
-readability purposes should be avoided.
+ - No backward or forward compatibility is offered for API changes marked as
+ ``experimental``, as described in the section on :ref:`Experimental APIs
+ and Libraries <experimental_apis>`.
-.. note::
+#. If a newly proposed API functionally replaces an existing one, when the new
+ API becomes non-experimental, then the old one is marked with
+ ``__rte_deprecated``.
+
+ - The depreciated API should follow the notification process to be removed,
+ see :ref:`deprecation_notices`.
+
+ - At the declaration of the next major ABI version, those ABI changes then
+ become a formal part of the new ABI and the requirement to preserve ABI
+ compatibility with the last major ABI version is then dropped.
+
+ - The responsibility for removing redundant ABI compatibility code rests
+ with the original contributor of the ABI changes, failing that, then with
+ the contributor's company and then finally with the maintainer.
+
+.. _forward-only:
+
+.. Note::
+
+ Note that forward-only compatibility is offered for those changes made
+ between major ABI versions. As a library's soname can only describe
+ compatibility with the last major ABI version, until the next major ABI
+ version is declared, these changes therefore cannot be resolved as a runtime
+ dependency through the soname. Therefore any application wishing to make use
+ of these ABI changes can only ensure that it's runtime dependencies are met
+ through Operating System package versioning.
+
+.. _hw_rqmts:
+
+.. Note::
Updates to the minimum hardware requirements, which drop support for hardware
which was previously supported, should be treated as an ABI change, and
- follow the relevant deprecation policy procedures as above: 3 acks and
- announcement at least one release in advance.
+ follow the relevant deprecation policy procedures as above: 3 acks, technical
+ board approval and announcement at least one release in advance.
+
+.. _abi_breakages:
+
+ABI Breakages
+~~~~~~~~~~~~~
+
+For those ABI changes that are too significant to reasonably maintain multiple
+symbol versions, there is an amended process. In these cases, ABIs may be
+updated without the requirement of backward compatibility being provided. These
+changes must follow the `same process :ref:`described above <abi_changes>` as non-breaking
+changes, however with the following additional requirements:
+
+#. ABI breaking changes (including an alternative map file) can be included with
+ deprecation notice, in wrapped way by the ``RTE_NEXT_ABI`` option, to provide
+ more details about oncoming changes. ``RTE_NEXT_ABI`` wrapper will be removed
+ at the declaration of the next major ABI version.
+
+#. Once approved, and after the depreciation notice has been observed these
+ changes will form part of the next declared major ABI version.
+
+Examples of ABI Changes
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The following are examples of allowable ABI changes occurring between
+declarations of major ABI versions.
+
+* DPDK 19.11 release, defines the function ``rte_foo()``, and ``rte_foo()``
+ as part of the major ABI version ``20``.
+
+* DPDK 20.02 release defines a new function ``rte_foo(uint8_t bar)``, and
+ this is not a problem as long as the symbol ``rte_foo@DPDK20`` is
+ preserved through :ref:`abi_versioning`.
+
+ - The new function may be marked with the ``__rte_experimental`` tag for a
+ number of releases, as described in the section :ref:`experimental_apis`.
+
+ - Once ``rte_foo(uint8_t bar)`` becomes non-experimental ``rte_foo()`` is then
+ declared as ``__rte_depreciated``, with an associated deprecation notice
+ provided.
+
+* DPDK 19.11 is not re-released to include ``rte_foo(uint8_t bar)``, the new
+ version of ``rte_foo`` only exists from DPDK 20.02 onwards as described in the
+ :ref:`note on forward-only compatibility<forward-only>`.
+
+* DPDK 20.02 release defines the experimental function ``__rte_experimental
+ rte_baz()``. This function may or may not exist in the DPDK 20.05 release.
+
+* An application ``dPacket`` wishes to use ``rte_foo(uint8_t bar)``, before the
+ declaration of the DPDK ``21`` major API version. The application can only
+ ensure it's runtime dependencies are met by specifying ``DPDK (>= 20.2)`` as
+ an explicit package dependency, as the soname only may only indicate the
+ supported major ABI version.
+
+* At the release of DPDK 20.11, the function ``rte_foo(uint8_t bar)`` becomes
+ formally part of then new major ABI version DPDK 21.0 and ``rte_foo()`` may be
+ removed.
+
+.. _deprecation_notices:
Examples of Deprecation Notices
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -106,46 +247,42 @@ Examples of Deprecation Notices
The following are some examples of ABI deprecation notices which would be
added to the Release Notes:
-* The Macro ``#RTE_FOO`` is deprecated and will be removed with version 2.0,
- to be replaced with the inline function ``rte_foo()``.
+* The Macro ``#RTE_FOO`` is deprecated and will be removed with ABI version
+ 21, to be replaced with the inline function ``rte_foo()``.
* The function ``rte_mbuf_grok()`` has been updated to include a new parameter
- in version 2.0. Backwards compatibility will be maintained for this function
- until the release of version 2.1
+ in version 20.2. Backwards compatibility will be maintained for this function
+ until the release of the new DPDK major ABI version 21, in DPDK version
+ 20.11.
-* The members of ``struct rte_foo`` have been reorganized in release 2.0 for
+* The members of ``struct rte_foo`` have been reorganized in DPDK 20.02 for
performance reasons. Existing binary applications will have backwards
- compatibility in release 2.0, while newly built binaries will need to
- reference the new structure variant ``struct rte_foo2``. Compatibility will
- be removed in release 2.2, and all applications will require updating and
+ compatibility in release 20.02, while newly built binaries will need to
+ reference the new structure variant ``struct rte_foo2``. Compatibility will be
+ removed in release 20.11, and all applications will require updating and
rebuilding to the new structure at that time, which will be renamed to the
original ``struct rte_foo``.
* Significant ABI changes are planned for the ``librte_dostuff`` library. The
- upcoming release 2.0 will not contain these changes, but release 2.1 will,
+ upcoming release 20.02 will not contain these changes, but release 20.11 will,
and no backwards compatibility is planned due to the extensive nature of
- these changes. Binaries using this library built prior to version 2.1 will
+ these changes. Binaries using this library built prior to ABI version 21 will
require updating and recompilation.
-New API replacing previous one
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If a new API proposed functionally replaces an existing one, when the new API
-becomes non-experimental then the old one is marked with ``__rte_deprecated``.
-Deprecated APIs are removed completely just after the next LTS.
-
-Reminder that old API should follow deprecation process to be removed.
+.. _experimental_apis:
+Experimental
+------------
-Experimental APIs
------------------
+APIs
+~~~~
-APIs marked as ``experimental`` are not considered part of the ABI and may
-change without warning at any time. Since changes to APIs are most likely
-immediately after their introduction, as users begin to take advantage of
-those new APIs and start finding issues with them, new DPDK APIs will be
-automatically marked as ``experimental`` to allow for a period of stabilization
-before they become part of a tracked ABI.
+APIs marked as ``experimental`` are not considered part of an ABI version and
+may change without warning at any time. Since changes to APIs are most likely
+immediately after their introduction, as users begin to take advantage of those
+new APIs and start finding issues with them, new DPDK APIs will be automatically
+marked as ``experimental`` to allow for a period of stabilization before they
+become part of a tracked ABI version.
Note that marking an API as experimental is a multi step process.
To mark an API as experimental, the symbols which are desired to be exported
@@ -163,7 +300,16 @@ In addition to tagging the code with ``__rte_experimental``,
the doxygen markup must also contain the EXPERIMENTAL string,
and the MAINTAINERS file should note the EXPERIMENTAL libraries.
-For removing the experimental tag associated with an API, deprecation notice
-is not required. Though, an API should remain in experimental state for at least
-one release. Thereafter, normal process of posting patch for review to mailing
-list can be followed.
+For removing the experimental tag associated with an API, deprecation notice is
+not required. Though, an API should remain in experimental state for at least
+one release. Thereafter, the normal process of posting patch for review to
+mailing list can be followed.
+
+Libraries
+~~~~~~~~~
+
+Libraries marked as ``experimental`` are entirely not considered part of an ABI
+version, and may change without warning at any time. Experimental libraries
+always have a major version of ``0`` to indicate they exist outside of
+:ref:`abi_versioning` , with the minor version incremented with each ABI change
+to library.
new file mode 100644
GIT binary patch
literal 61277
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
literal 0
HcmV?d00001
@@ -1,7 +1,7 @@
.. SPDX-License-Identifier: BSD-3-Clause
Copyright 2018 The DPDK contributors
-.. stable_lts_releases:
+.. _stable_lts_releases:
DPDK Stable Releases and Long Term Support
==========================================
@@ -53,6 +53,9 @@ year's November (X.11) release will be maintained as an LTS for 2 years.
After the X.11 release, an LTS branch will be created for it at
http://git.dpdk.org/dpdk-stable where bugfixes will be backported to.
+A LTS release may align with the declaration of a new major ABI version,
+please read the :ref:`abi_policy` for more information.
+
It is anticipated that there will be at least 4 releases per year of the LTS
or approximately 1 every 3 months. However, the cadence can be shorter or
longer depending on the number and criticality of the backported
@@ -119,10 +122,3 @@ A Stable Release will be released by:
list.
Stable releases are available on the `dpdk.org download page <http://core.dpdk.org/download/>`_.
-
-
-ABI
----
-
-The Stable Release should not be seen as a way of breaking or circumventing
-the DPDK ABI policy.