File: README

package info (click to toggle)
abi-dumper 0.99.16-2
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 436 kB
  • sloc: perl: 9,739; makefile: 20
file content (42 lines) | stat: -rw-r--r-- 1,185 bytes parent folder | download
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
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.
  
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

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

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

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