42 lines
1.2 KiB
Text
42 lines
1.2 KiB
Text
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.
|