numam-dpdk/doc/guides/contributing
Christian Ehrhardt 630f6ec11e mk: provide option to set major ABI version
Downstreams might want to provide different DPDK releases at the same
time to support multiple consumers of DPDK linked against older and newer
sonames.

Also due to the interdependencies that DPDK libraries can have applications
might end up with an executable space in which multiple versions of a
library are mapped by ld.so.

Think of LibA that got an ABI bump and LibB that did not get an ABI bump
but is depending on LibA.

    Application
    \-> LibA.old
    \-> LibB.new -> LibA.new

That is a conflict which can be avoided by setting CONFIG_RTE_MAJOR_ABI.
If set CONFIG_RTE_MAJOR_ABI overwrites any LIBABIVER value.
An example might be ``CONFIG_RTE_MAJOR_ABI=16.11`` which will make all
libraries librte<?>.so.16.11 instead of librte<?>.so.<LIBABIVER>.

We need to cut arbitrary long stings after the .so now and this would work
for any ABI version in LIBABIVER:
  $(Q)ln -s -f $< $(patsubst %.$(LIBABIVER),%,$@)
But using the following instead additionally allows to simplify the Make
File for the CONFIG_RTE_NEXT_ABI case.
  $(Q)ln -s -f $< $(shell echo $@ | sed 's/\.so.*/.so/')

Signed-off-by: Christian Ehrhardt <christian.ehrhardt@canonical.com>
Reviewed-by: Jan Blunck <jblunck@infradead.org>
Tested-by: Jan Blunck <jblunck@infradead.org>
2017-03-16 18:20:01 +01:00
..
img doc: add patch submit cheatsheet 2015-12-14 23:17:33 +01:00
cheatsheet.rst doc: add patch submit cheatsheet 2015-12-14 23:17:33 +01:00
coding_style.rst doc: add required python versions 2017-01-04 21:14:09 +01:00
design.rst doc: update for VFD experimental API 2017-01-17 19:48:02 +01:00
documentation.rst doc: use corelist instead of coremask 2017-03-01 20:39:58 +01:00
index.rst doc: add guidelines on stable and lts releases 2017-02-08 15:33:36 +01:00
patches.rst doc: add details on requirements for patch ack and merge 2017-03-09 14:48:22 +01:00
stable.rst doc: add guidelines on stable and lts releases 2017-02-08 15:33:36 +01:00
versioning.rst mk: provide option to set major ABI version 2017-03-16 18:20:01 +01:00