The ABI Generic Analysis and Instrumentation Library

Table of Contents


This project aims at providing a C++ library for constructing, manipulating, serializing and de-serializing ABI-relevant artifacts. The set of artifacts that we are interested in is made of constructions like types, variables, functions and declarations of a given library or program. For a given program or library, this set of constructions is called an ABI corpus.

Thus the project aims at providing a library to manipulate ABI corpora, compare them, provide detailed information about their differences and help build tools to infer interesting conclusions about these differences.


The documentations of the libabigail tools is available online here.

The html documentation of the API of the library itself is available online here.

IRC and Mailing lists

To hang out with libabigail developers and users, you can chat with us via IRC at irc://

To send us patches or just drop by to say Hi, please send an email to our mailing list libab.nosp@m.igai.nosp@m.l@sou.nosp@m.rcew.nosp@m.are.o.nosp@m.rg. The archives of the mailing list can be read online. To send us an email, you first need to register to the mailing list by feeling the form below.

Mailing list name:
Your e-mail address:
Digest version    

Bug reports

Bug reports are to be filed into our Bugzilla database.


The source code of the library is under LGPL version 3 or later.

Getting the source code

This project is still in an early stage; we haven't released any official tarball yet. You can get the source code in a read-only manner from our Git repository by doing:

git clone git://

If you have write access on, you can check the source out in read-write by doing:

git clone ssh://

Compiling the source code

To compile libabigail, you first need to install its dependencies. At the moment the dependencies are the following Free Software packages:

Then go to your local libabigail.git directory where the source code you've checked out lies and create a 'build' directory that will receive the binaries resulting from the compilation:

cd libabigail
mkdir build

Generate the relevant build-system-related information needed to configure the package for compilation, by typing:

autoreconf -i

Then configure the package:

cd build
../configure --prefix=<absolute-path-of-where-you-want-the-binaries-to-be-installed>

Then build the package


And then install its resulting binaries and documentation:

make install