[urcu.git] / extras / abi / README

This directory contains the serialized ABI definitions for a typical build of
the liburcu libraries. This information is extracted using libabigail
(https://sourceware.org/libabigail/).

The artefacts used to generate these were built with CFLAGS="-O0 -ggdb" on an
Ubuntu 18.04 x86_64 system.

You can compare the serialized ABI with a shared object to check for breaking
changes. For example, here we compare an in-tree built version of
liburcu-memb.so with the serialized ABI of stable-0.13 :

  abidiff \
    extras/abi/0.13/x86_64-pc-linux-gnu/liburcu-memb.so.8.xml \
    src/.libs/liburcu-memb.so
Commit	Line	Data
c0ecb6ea	1	This directory contains the serialized ABI definitions for a typical build of
f99c6e92	2	the liburcu libraries. This information is extracted using libabigail
c0ecb6ea MJ	3	(https://sourceware.org/libabigail/).
c0ecb6ea MJ	4
2ff9a79d MJ	5	The artefacts used to generate these were built with CFLAGS="-O0 -ggdb" on an
2ff9a79d MJ	6	Ubuntu 18.04 x86_64 system.
c0ecb6ea MJ	7
	8	You can compare the serialized ABI with a shared object to check for breaking
	9	changes. For example, here we compare an in-tree built version of
	10	liburcu-memb.so with the serialized ABI of stable-0.13 :
	11
	12	abidiff \
2ff9a79d	13	extras/abi/0.13/x86_64-pc-linux-gnu/liburcu-memb.so.8.xml \
c0ecb6ea	14	src/.libs/liburcu-memb.so