abi_checker

Purpose:

Check the compatibility between 2 libraries using abi-compliance.

Enter:

abi_checker <library> <old_cyflex_ver> <new_cyflex_ver> [app=application] [old_ver_num] [new_ver_num]

Where:

library

the library to look at

old_cyflex_ver

the old cyflex version

new_cyflex_ver

the new cyflex version

application:

Optional argument that checks compatibility for an application for the new library using the old one. Must have app=[application] for this option. Should use full path of executable desired

old_ver_num:

Optional argument for the old lib num, default 1

new_ver_num:

Optional argument for the new lib num, default 2

Example:

abi_checker  libSoftingCan  /cyflex.6.2.16.rel/  /cyflex.6.2.exp/

This checks the libSoftingCan.so between the 2 versions and sees if they are compatible.

abi_checker all /cyflex.6.2.16.rel/ /cyflex.6.2.exp/

This opens the cyflex_so_ver.dat file in /cyflex.6.2.exp/ and compares that to the cyflex_so_ver.dat file in /cyflex.6.2.16.rel/ directory. It generates 2 files, /tmp/abi_report and /tmp/abi_output.

Notes:

If the argument library is set to ‘all’, it will look at all libraries in the new_cyflex_ver and check against all in the old_cyflex_ver. The optional arguments are useless when using the ‘all’ option.

When running without the ‘all’ option, a report is created in /tmp/compat_reports/‘library’/. In the /tmp/compat_reports/‘library’/ directory are more directories. These directories hold html files that can be opened with a web browser to view information about the comparison.

These directories get there name from the optional arguments. If the default are used, then the directory ‘1_to_2’ is created since the default are 1 and 2. The optional arguments do NOT need to be numbers only.

If app= is used, it must be before the ver_num optional arguments if those want to be used as well.

See Also: