numam-dpdk/buildtools
Ferruh Yigit 05a38d7c75 compat: provide experimental alias for matured ABI
On v20.02 some APIs matured and symbols moved from EXPERIMENTAL to
DPDK_20.0.1 block.

This had the affect of breaking the applications that were using these
APIs on v19.11. Although there is no modification of the APIs and the
action is positive and matures the APIs, the affect can be negative to
applications.

When a maintainer is promoting an API to become part of the next major
ABI version by removing the experimental tag. The maintainer may
choose to offer an alias to the experimental tag, to prevent these
breakages in future.

The following changes are made to enabling aliasing:

Updated to the ABI policy and ABI versioning documents.

Created VERSION_SYMBOL_EXPERIMENTAL helper macro.

Updated the 'check-symbols.sh' tool, which was complaining that the
symbol is in EXPERIMENTAL tag in .map file but it is not in the
.experimental section (__rte_experimental tag is missing).
Updated tool in a way it won't complain if the symbol in the
EXPERIMENTAL tag duplicated in some other block in .map file (versioned)

Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
Signed-off-by: Ray Kinsella <mdr@ashroe.eu>
Acked-by: Neil Horman <nhorman@tuxdriver.com>
2020-05-18 19:46:25 +02:00
..
pmdinfogen eal: move common header files 2020-03-31 13:08:55 +02:00
auto-config-h.sh buildtools: fix build for some mktemp 2018-10-27 15:30:25 +02:00
call-sphinx-build.py doc: rebuild with meson whenever a file changes 2020-01-15 08:50:28 +01:00
check-symbols.sh compat: provide experimental alias for matured ABI 2020-05-18 19:46:25 +02:00
gen-build-mk.sh mk: allow renaming of build directories 2018-11-14 01:46:00 +01:00
gen-config-h.sh tools: use SPDX tag for Intel copyright files 2018-01-04 22:41:39 +01:00
gen-pmdinfo-cfile.sh buildtools: allow pedantic empty pmdinfo 2020-02-05 18:19:00 +01:00
list-dir-globs.py build: allow using wildcards to disable drivers 2020-02-06 09:17:24 +01:00
Makefile buildtools: change license to SPDX 2018-07-26 22:45:17 +02:00
map_to_def.py build: generate Windows exports file 2019-06-05 19:49:28 +02:00
map-list-symbol.sh buildtools: detect discrepancies for experimental symbols 2019-06-29 19:04:32 +02:00
meson.build build: add internal tag check 2020-04-25 17:01:01 +02:00
options-ibverbs-static.sh buildtools: get static mlx dependencies for meson 2020-02-14 12:42:13 +01:00
relpath.sh tools: use SPDX tag for Intel copyright files 2018-01-04 22:41:39 +01:00
symlink-drivers-solibs.sh build: fix ninja install on FreeBSD 2019-05-02 23:07:04 +02:00