Binary Compatibility - Revision history

Aponomarenko: /* Build two versions of the library with debug info */ fix for 1.1

2018-09-13T13:35:38Z

Build two versions of the library with debug info: fix for 1.1

Aponomarenko: /* Compare ABI dumps to produce report */

2017-02-26T06:20:07Z

Compare ABI dumps to produce report

Aponomarenko: /* Make ABI dumps of the library versions */

2017-02-26T06:19:49Z

Make ABI dumps of the library versions

Aponomarenko: /* Compare ABI dumps to produce report */

2017-02-26T06:19:12Z

Compare ABI dumps to produce report

Aponomarenko: /* Make ABI dumps of the library versions */

2017-02-26T06:17:42Z

Make ABI dumps of the library versions

Aponomarenko: Fixed internal link

2015-10-26T12:24:36Z

Fixed internal link

Aponomarenko: Page about a method to test binary compatibility

2015-10-26T10:15:23Z

Page about a method to test binary compatibility

New page

This approach allows to manually detect most of the possible binary compatibility issues between any particular releases of the OpenSSL. Alternatively one can set up a local instance of the [[ABI tracker]] for OpenSSL to automate analysis for sequential releases of the library.

== Build two versions of the library with debug info ==
The library should be built with '''-g''' and '''-Og''' options of the GCC compiler and installed to a local directory (PREFIX=/home/USER):

./config -d --prefix=$PREFIX/openssl-1.0.2d/ shared
sed -i -e 's/ \-O0 / /' Makefile
sed -i -e 's/ \-g / -g -Og /' Makefile
make
make install_sw

== Make ABI dumps of the library versions ==
Install [https://github.com/lvc/abi-dumper abi-dumper] tool (0.99.11 or newer) and run it on shared objects to create ABI dumps:

abi-dumper -o libssl-1.0.2.d.abi -public-headers $PREFIX/openssl-1.0.2d/include/ -vnum 1.0.2d $PREFIX/openssl-1.0.2d/lib/libssl.so.1.0.0

The -public-headers option is needed to filter out private part of the ABI.

== Compare ABI dumps to produce report ==
Install [https://github.com/lvc/abi-compliance-checker abi-compliance-checker] tool (1.99.13 or newer) and run it on two ABI dumps to create report:

abi-compliance-checker -l libssl -bin -old libssl-1.0.2.c.abi -new libssl-1.0.2.d.abi -headers-list ./headers.list -report-path ./report.html

← Older revision		Revision as of 06:20, 26 February 2017
Line 21:		Line 21:
	Install [https://github.com/lvc/abi-compliance-checker abi-compliance-checker] tool (1.99.13 or newer) and run it on two ABI dumps to create report:		Install [https://github.com/lvc/abi-compliance-checker abi-compliance-checker] tool (1.99.13 or newer) and run it on two ABI dumps to create report:

−	abi-compliance-checker -l libssl -bin -old libssl-1.0.~~2.c~~.abi -new libssl-1.0.~~2.d~~.abi -report-path ./report.html	+	abi-compliance-checker -l libssl -bin -old libssl-1.0.2c.abi -new libssl-1.0.2d.abi -report-path ./report.html

@@ Line 14: / Line 14: @@
 Install [https://github.com/lvc/abi-dumper abi-dumper] tool (1.0 Beta or newer) and run it on shared objects to create ABI dumps:
-   abi-dumper -o libssl-1.0.2.d.abi -public-headers $PREFIX/openssl-1.0.2d/include/ -vnum 1.0.2d $PREFIX/openssl-1.0.2d/lib/libssl.so.1.0.0
+   abi-dumper -o libssl-1.0.2d.abi -public-headers $PREFIX/openssl-1.0.2d/include/ -vnum 1.0.2d $PREFIX/openssl-1.0.2d/lib/libssl.so.1.0.0
 The -public-headers option is needed to filter out private part of the ABI.

← Older revision		Revision as of 06:19, 26 February 2017
Line 21:		Line 21:
	Install [https://github.com/lvc/abi-compliance-checker abi-compliance-checker] tool (1.99.13 or newer) and run it on two ABI dumps to create report:		Install [https://github.com/lvc/abi-compliance-checker abi-compliance-checker] tool (1.99.13 or newer) and run it on two ABI dumps to create report:

−	abi-compliance-checker -l libssl -bin -old libssl-1.0.2.c.abi -new libssl-1.0.2.d.abi ~~-headers-list ./headers.list~~ -report-path ./report.html	+	abi-compliance-checker -l libssl -bin -old libssl-1.0.2.c.abi -new libssl-1.0.2.d.abi -report-path ./report.html

← Older revision		Revision as of 12:24, 26 October 2015
Line 1:		Line 1:

−	This approach allows to manually detect most of the possible binary compatibility issues between any particular releases of the OpenSSL. Alternatively one can set up a local instance of the [[ABI tracker]] for OpenSSL to automate analysis for sequential releases of the library.	+	This approach allows to manually detect most of the possible binary compatibility issues between any particular releases of the OpenSSL. Alternatively one can set up a local instance of the [[ABI Tracker\|ABI tracker]] for OpenSSL to automate analysis for sequential releases of the library.

	== Build two versions of the library with debug info ==		== Build two versions of the library with debug info ==

@@ Line 6: / Line 6: @@
    ./config -d --prefix=$PREFIX/openssl-1.0.2d/ shared
-   sed -i -e 's/ \-O0 / /' Makefile
+   sed -i -e 's/ \-O0 / -g -Og /' Makefile
-   sed -i -e 's/ \-g / -g -Og /' Makefile
+   sed -i -e 's/ \-g/ -g -Og/' Makefile
    make
    make install_sw

@@ Line 12: / Line 12: @@
 == Make ABI dumps of the library versions ==
-Install [https://github.com/lvc/abi-dumper abi-dumper] tool (0.99.11 or newer) and run it on shared objects to create ABI dumps:
+Install [https://github.com/lvc/abi-dumper abi-dumper] tool (1.0 Beta or newer) and run it on shared objects to create ABI dumps:
    abi-dumper -o libssl-1.0.2.d.abi -public-headers $PREFIX/openssl-1.0.2d/include/ -vnum 1.0.2d $PREFIX/openssl-1.0.2d/lib/libssl.so.1.0.0