From 8bfdcd89d96039c2f655682c39386097759501ce Mon Sep 17 00:00:00 2001 From: Andrey Ponomarenko Date: Tue, 8 Sep 2015 17:58:01 +0300 Subject: Released 1.99.10 --- README | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) (limited to 'README') diff --git a/README b/README index c624b80..a859ae3 100644 --- a/README +++ b/README @@ -1,8 +1,20 @@ NAME: - ABI Compliance Checker (ACC) - a tool for checking backward binary and source-level compatibility of a shared C/C++ library API. + ABI Compliance Checker (ACC) - a tool for checking backward binary and source-level compatibility of a C/C++ software library. + + The tool checks header files and shared objects of old and new versions and analyzes changes in API/ABI that may break binary and/or source compatibility: changes in calling stack, v-table changes, removed symbols, renamed fields, etc. + + The tool is intended for developers of software libraries and Linux maintainers who are interested in ensuring backward compatibility, i.e. allow old applications to run or to be recompiled with newer library versions. + + The tool is developed by Andrey Ponomarenko. You can order additional reports for visualization of the ABI structure and high detailed binary compatibility analysis here: http://abi-laboratory.pro/ INSTALL: - sudo perl Makefile.pl -install --prefix=/usr + sudo make install prefix=/usr + +REQUIRES: + Perl 5 + G++ + GNU Binutils + Ctags USAGE: abi-compliance-checker -lib NAME -old OLD.xml -new NEW.xml @@ -29,8 +41,8 @@ COMPATIBILITY: USAGE WITH ABI DUMPER: - 1. Library should be compiled with -g - option to contain DWARF debug info + 1. Library should be compiled with "-g -Og" GCC options + to contain DWARF debug info 2. Create ABI dumps for both library versions using the ABI Dumper (https://github.com/lvc/abi-dumper) tool: @@ -40,4 +52,4 @@ USAGE WITH ABI DUMPER: 3. Compare ABI dumps: - abi-compliance-checker -l NAME -old ABI-0.dump -new ABI-1.dump \ No newline at end of file + abi-compliance-checker -l NAME -old ABI-0.dump -new ABI-1.dump -- cgit v1.2.3