NAME:
  ABI Dumper — a tool to dump ABI of an ELF object containing DWARF debug info.

  The tool is intended to be used with ABI Compliance Checker tool for tracking
  ABI changes of a C/C++ library or kernel module.

  The tool is developed by Andrey Ponomarenko: http://abi-laboratory.pro/

INSTALL:
  sudo make install prefix=/usr

REQUIRES:
  Perl 5 (5.8 or newer)
  Elfutils (eu-readelf)
  Vtable Dumper (1.0 or newer, https://github.com/lvc/vtable-dumper)
  Universal Ctags

USAGE:
  abi-dumper libTest.so -o ABI.dump
  abi-dumper Module.ko.debug

EXAMPLES:
  abi-dumper lib/libssh.so.3
  abi-dumper drm/nouveau/nouveau.ko.debug

NOTE:
  Input objects should be compiled with -g -Og additional options to contain DWARF debug info.

FILTER PUBLIC ABI:
  abi-dumper libTest.so -public-headers PATH
  PATH — path to the install tree of a library

ABI CHECK:
  abi-dumper libTest.so.0 -o ABIv0.dump
  abi-dumper libTest.so.1 -o ABIv1.dump
  abi-compliance-checker -l libTest -old ABIv0.dump -new ABIv1.dump

COMPATIBILITY:
  ABI Compliance Checker >= 1.99.24 (https://github.com/lvc/abi-compliance-checker)

ADV. USAGE:
  For advanced usage, see output of --help option.

URL: https://github.com/lvc/abi-dumper/archive/0.99.18.tar.gz
Version: 0.99.18
License: GPL2.0, LGPL2.0
License File: LICENSE

Description:
This tool produces an ABI dump of a C/C++ library. This ABI dump can be used by
abi-compliance-checker in order to check ABI compliance with another version of
the library.

Local Modifications:
Add command-line options to specify paths to objdump, g++ and readelf. Also,
modify abi-dumper.pl to parse readelf's output instead of eu-readelf. eu-readelf
is not available as a prebuilt whereas readelf is. Modifications to enable usage
of custom vtable dumepr. Give +x permissions to abi-dumper.pl .