X-Git-Url: https://git.lttng.org/?p=urcu.git;a=blobdiff_plain;f=extras%2Fabi%2FREADME;fp=extras%2Fabi%2FREADME;h=a74ec1bf350cfaf630dfa5f1a36bb73bd05b179b;hp=0000000000000000000000000000000000000000;hb=c0ecb6ea53e564c5bca028070b43793afb77a790;hpb=3a50dfc27e0ae7e28ed9861646eb4a2ba63a67a6

diff --git a/extras/abi/README b/extras/abi/README
new file mode 100644
index 0000000..a74ec1b
--- /dev/null
+++ b/extras/abi/README
@@ -0,0 +1,13 @@
+This directory contains the serialized ABI definitions for a typical build of
+the liburcu librairies. This information is extracted using libabigail
+(https://sourceware.org/libabigail/).
+
+The artefacts used to generate these were built with CFLAGS="-O0 -ggdb".
+
+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.7.xml \
+    src/.libs/liburcu-memb.so