1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47
|
ABI Dumper 1.1
==============
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: https://abi-laboratory.pro/
INSTALL:
sudo make install prefix=/usr
REQUIRES:
Perl 5
Elfutils (eu-readelf)
GNU Binutils
Vtable Dumper >= 1.1 (https://github.com/lvc/vtable-dumper)
Universal Ctags (https://github.com/universal-ctags/ctags)
GCC C++
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 >= 2.2 (https://github.com/lvc/abi-compliance-checker)
ADV. USAGE:
For advanced usage, see output of --help option.
|