diff options
| author | Andrey Ponomarenko <aponomarenko@rosalab.ru> | 2015-08-13 20:14:50 +0300 |
|---|---|---|
| committer | Andrey Ponomarenko <aponomarenko@rosalab.ru> | 2015-08-13 20:14:50 +0300 |
| commit | d48d972d47a4159bb67f7d741614fbf9851c3887 (patch) | |
| tree | 2aa69c07a3dc70222f6868a13296ad3a65539d99 | |
| parent | 52b2e35f3dfda9369631beeb5d5480df65c47950 (diff) | |
| download | abi-compliance-checker-d48d972d47a4159bb67f7d741614fbf9851c3887.tar.gz | |
New documentation.
| -rw-r--r-- | doc/Changelog.html | 1887 | ||||
| -rw-r--r-- | doc/Changes.html | 1091 | ||||
| -rw-r--r-- | doc/Descriptor.html | 514 | ||||
| -rw-r--r-- | doc/Options.html | 293 | ||||
| -rw-r--r-- | doc/Readme.html | 503 | ||||
| -rw-r--r-- | doc/SysCheck/Descriptor.html | 237 | ||||
| -rw-r--r-- | doc/SysCheck/Examples.html | 243 | ||||
| -rw-r--r-- | doc/SysCheck/Usage.html | 120 | ||||
| -rw-r--r-- | doc/Xml-Descriptor.html | 602 | ||||
| -rw-r--r-- | doc/index.html | 708 |
10 files changed, 3197 insertions, 3001 deletions
diff --git a/doc/Changelog.html b/doc/Changelog.html new file mode 100644 index 0000000..f782e31 --- /dev/null +++ b/doc/Changelog.html @@ -0,0 +1,1887 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <meta name="description" content="Changelog for ABI Compliance Checker" /> + <title>ABI Compliance Checker: History</title> + + <style type="text/css"> + body { + margin-top: 1.0em; + background-color: #deeef7; + font-family: Helvetica, Arial, FreeSans, san-serif; + color: #000000; + } + #container { + margin: 0 auto; + width: 700px; + } + h1 { font-size: 3.8em; color: #211108; margin-bottom: 3px;margin-top:0px;padding-top:0px;} + h1 .small { font-size: 0.4em; } + h1 a { text-decoration: none } + h2 { font-size: 1.5em; color: #211108; } + h3 { text-align: center; color: #211108; } + a { color: #211108; } + .description { font-size: 1.2em; margin-bottom: 30px; margin-top: 30px; font-style: italic;} + .download { float: right; } + pre {padding: 0px;margin: 0px;padding-left: 10px;word-wrap:break-word;white-space: pre-wrap;} + hr { border: 0; width: 80%; border-bottom: 1px solid #aaa} + .footer { text-align:center; padding-top:30px; font-style: italic; } + .code {border: dashed 1px gray; background-color: #f0f0f0;} + .listing {padding: 10px;border: 1px solid black;width: 70%;font-family:"DejaVu Sans Mono", "Monaco", "Courier New", monospace;font-size:14px;} + .summary {border:1px solid black;border-collapse:collapse;} + table.summary td, table.summary th {border:1px solid black;padding:2px;} + </style> + +</head> + +<body> +<a href="https://github.com/lvc/abi-compliance-checker"><img style="position: absolute; top: 0; right: 0; border: 0;" src="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" /></a> + +<div id="container"> + +<h1>ABI Compliance<br/>Checker: History</h1> +<p/> +<br/> + +<b>Version 1.99.9 (January 23, 2014)</b><br/> +<b>New Options</b> +<ul> + <li> + -skip-internal: do not check internal interfaces matched by the pattern + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Fixed duplicated entries in the XML report + </li> + <li> + Reduced size of the XML report + </li> + <li> + Fixed duplicated problems related to changed size of a global data + </li> + <li> + Options -v1 and -v2 can now be used when comparing ABI dumps to change library versions shown in the report + </li> + <li> + Fixed false positives with the size change of a template instance type + </li> + <li> + Fixed false positives with the change of a parameter/field type name + </li> +</ul> +<br/> + +<b>Version 1.99.8.5 (October 03, 2013)</b><br/> +<b>Improvements</b> +<ul> + <li> + Optimized performance and memory usage (up to 90%) on input objects with a huge number of changes and deep data type trees (e.g. Linux kernel) + </li> + <li> + Partial support for GCC 4.8.{0-1}, waiting for a fix for the bug <a href='http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57850'>57850</a> in the next GCC versions + </li> + <li> + Support for incomplete ABI dumps + </li> +</ul> +<b>New Options</b> +<ul> + <li> + -affected-limit + </li> + <li> + -cpp-incompatible + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Fixed identification of template constructors and destructors + </li> + <li> + Do not show "this" first argument of methods in the report + </li> + <li> + Corrected descriptions of affected symbols in the report + </li> + <li> + Fixed false alarms on changed offset of parameters + </li> + <li> + Do not hang on class A<N>:public A<N-1> + </li> + <li> + Corrected identification of header files in the include_preamble + </li> + <li> + Corrected comparison of function pointer types + </li> + <li> + Corrected rule Global_Data_Size + </li> +</ul> +<b>Other</b> +<ul> + <li> + Code refactoring + </li> +</ul> +<br/> + +<b>Version 1.99.7 (July 01, 2013)</b><br/> +<b>Improvements</b> +<ul> + <li> + Added missed fields of template instance types to the ABI dump + </li> + <li> + Improved support for old ABI dumps + </li> + <li> + Added Struct_Field_Size_Increased rule + </li> + <li> + Support for vector types (GCC extension) + </li> + <li> + Removed duplicates from the ABI dump + </li> + <li> + Corrected visualization of v-table content in the report + </li> + <li> + Corrected identification of target headers + </li> + <li> + Corrected source-compatibility check + </li> + <li> + Performance optimization (5%) + </li> +</ul> +<b>New Options</b> +<ul> + <li> + -check - to check completeness of the ABI dump + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Fixed default arguments of methods (broken in 1.99.1 due to added "this" parameter) + </li> +</ul> +<b>Other</b> +<ul> + <li> + Extended test suite + </li> +</ul> +<br/> + +<b>Version 1.99.1 (June 07, 2013)</b><br/> +<b>Improvements</b> +<ul> + <li> + Support for ABI Dumper 0.97 + </li> + <li> + Show added/removed inline virtual functions in the binary compatibility report + </li> + <li> + Added "this" hidden parameter to non-static class methods in the ABI dump + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Fixed XmlDump module + </li> + <li> + Fixed CallConv module + </li> +</ul> +<b>Other</b> +<ul> + <li> + Support for old ABI dumps + </li> +</ul> +<br/> + +<b>Version 1.99 (May 24, 2013)</b><br/> +<b>Improvements</b> +<ul> + <li> + Support for ABI Dumper 0.95 + </li> + <li> + Added 14 binary-compatibility rules + </li> + <li> + Added 10 source-compatibility rules + </li> + <li> + Improved model of type alignment + </li> + <li> + Changed version of ABI dump format to 3.0 + </li> + <li> + Added _vptr member to virtual classes + </li> + <li> + Added constants defined by GCC to ABI dump + </li> + <li> + Improved analysis of constants + </li> +</ul> +<b>New Options</b> +<ul> + <li> + -skip-symbols + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Increased severity of Field_Became_Non_Mutable rule + </li> +</ul> +<b>Other</b> +<ul> + <li> + Support for old ABI dumps + </li> + <li> + Extended test suite (+11 test cases) + </li> + <li> + Code cleaning + </li> +</ul> +<br/> + +<b>Version 1.98.8 (February 07, 2013)</b><br/> +<b>Improvements</b> +<ul> + <li> + Show added and removed constants (#defines) in the report + </li> + <li> + Show changes in unnamed enumerations + </li> + <li> + Avoid false alarm about renamed field if old name of this field is defined to new (SC) + </li> + <li> + Recursive comparing of structured data types in *_Format rules + </li> + <li> + Added Typedef_BaseType_Format rule to check format changes in the typedef base type + </li> +</ul> +<b>New Options</b> +<ul> + <li> + -tolerant + </li> + <li> + -tolerance + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Increased severity of Parameter_BaseType_And_Size BC rule (Low to Medium) + </li> + <li> + Increased severity of Added_Field SC rule (Safe to Low) + </li> + <li> + Corrected handling of the tool error codes in the test suite + </li> + <li> + Corrected handling of relative paths in the descriptor options + </li> + <li> + Skipping linker-related options in gcc_options option of the descriptor + </li> + <li> + Corrected internal mangler for C++ functions + </li> + <li> + Corrected conditions for enabling of C++ compatibility mode + </li> + <li> + Corrected handling of C++ keywords in C-code + </li> + <li> + Corrected -extended option + </li> + <li> + Corrected Typedef_BaseType rule + </li> + <li> + Corrected parsing of default function arguments + </li> + <li> + Do not check presence of archive utilities if not used + </li> + <li> + Other fixes + </li> +</ul> +<b>Other</b> +<ul> + <li> + Extended test suite + </li> + <li> + Code cleaning + </li> +</ul> +<br/> + +<b>Version 1.98.7 (December 14, 2012)</b><br/> +<b>Improvements</b> +<ul> + <li> + Extended extra info dumped by -extra-info option + </li> + <li> + Extended additional info dumped by -extra-dump option + </li> + <li> + Added specifiers for structs, unions and enums in the report and ABI dump + </li> + <li> + Improved support for old ABI dumps + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected -debug option + </li> + <li> + Corrected creating of archives with ABI dumps + </li> + <li> + Corrected parsing of includes in header files + </li> + <li> + Corrected processing of undefined symbols + </li> + <li> + Corrected -app option + </li> + <li> + Corrected processing of default paths to system libraries + </li> + <li> + Corrected Makefile + </li> + <li> + Other fixes + </li> +</ul> +<b>Other</b> +<ul> + <li> + Code cleaning and refactoring + </li> +</ul> +<br/> + +<b>Version 1.98.6 (December 04, 2012)</b><br/> +<b>Improvements</b> +<ul> + <li> + Extended -extra-info and -extra-dump options + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected processing of input XML descriptor + </li> + <li> + Corrected "Parameter_Default_Value_Removed" rule + </li> + <li> + Other fixes + </li> +</ul> +<b>Other</b> +<ul> + <li> + Code cleaning + </li> +</ul> +<br/> + +<b>Version 1.98.5 (November 30, 2012)</b><br/> +<b>Improvements</b> +<ul> + <li> + Support for Mac OS X 10.8 + </li> + <li> + Support for OpenBSD + </li> + <li> + Support for old GCC versions <= 4.2 + </li> + <li> + Added "throw" and "weak" attributes of methods to ABI dump + </li> +</ul> +<b>New Options</b> +<ul> + <li> + -extra-info + </li> + <li> + -extra-dump + </li> + <li> + -force + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected order of user-defined include paths + </li> + <li> + Corrected internal C++ mangler + </li> + <li> + Removed false positives of the "Parameter_Type_Format" rule + </li> + <li> + Other fixes + </li> +</ul> +<b>Other</b> +<ul> + <li> + Extended test suite + </li> + <li> + Code cleaning + </li> + <li> + Docs cleaning + </li> +</ul> +<br/> + +<b>Version 1.98.4 (October 18, 2012)</b><br/> +<b>Improvements</b> +<ul> + <li> + Optimization of memory usage (5%-10%) and performance (5%-10%) + </li> + <li> + Added "Used Reserved Field" rule of binary compatibility analysis + </li> + <li> + Improved design of the operating system compatibility report + </li> + <li> + Added meta descriptors for 334 libraries + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Fixed an issue with diagnostics of added virtual functions + </li> + <li> + Corrected the list of functions affected by the compatibility problem + </li> + <li> + Avoid false alarm about removed function if this function became macro (SC) + </li> + <li> + Corrected parser of C header files + </li> + <li> + Other fixes + </li> +</ul> +<b>Other</b> +<ul> + <li> + Extended test suite + </li> + <li> + Code cleaning + </li> +</ul> +<br/> + +<b>Version 1.98.3 (July 19, 2012)</b><br/> +<b>Improvements</b> +<ul> + <li> + Implemented a model of calling conventions on x86 and x86_64 + </li> + <li> + Improved diagnostics of changes in function parameters and return value (distribution on registers and stack) + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected parser of C++ header files to detect non-member functions inside namespaces + </li> +</ul> +<b>Other</b> +<ul> + <li> + Added requirement for Ctags (5.8 or newer) + </li> + <li> + Code cleaning + </li> +</ul> +<br/> + +<b>Version 1.98.2 (June 26, 2012)</b><br/> +<b>Improvements</b> +<ul> + <li> + Support for reading ABI dumps in XML format + </li> + <li> + Automatic enabling of c++0x support if needed to compile headers + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected XML and Perl (default) formats of ABI dumps + </li> + <li> + Improved support for old ABI dumps + </li> + <li> + Improved -dump-system option + </li> +</ul> +<b>Other</b> +<ul> + <li> + Improved documentation + </li> +</ul> +<br/> + +<b>Version 1.98.1 (June 18, 2012)</b><br/> +<b>Bug Fixes</b> +<ul> + <li> + Removed symbols marked as LOCAL in a shared library from lists of added/removed symbols in source-compatibility report + </li> + <li> + Fixed a false positive with some removed extern "C" symbols in source-compatibility report + </li> + <li> + Fixed a bug with removed debug/ directory when using -use-dumps and -debug options together + </li> + <li> + Added support for "skip_including" section of target system XML descriptors (modules/Targets) used by -dump-system option + </li> + <li> + Extended XML ABI dumps by size attribute of library symbols + </li> +</ul> +<br/> + +<b>Version 1.98.0 (June 14, 2012)</b><br/> +<b>New Features</b> +<ul> + <li> + Implemented XML format of ABI dumps + </li> +</ul> +<b>New Options</b> +<ul> + <li> + -dump-format + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Improved support for old ABI dumps + </li> + <li> + Other fixes + </li> +</ul> +<br/> + +<b>Version 1.97.8 (June 08, 2012)</b><br/> +<b>Improvements</b> +<ul> + <li> + Redesigned format of ABI dump + </li> + <li> + Optimization of memory usage (5%-10%) and performance (5%-10%) + </li> + <li> + Improved support for GCC 4.0-4.5 + </li> + <li> + Added "add_namespaces" section of the XML descriptor + </li> +</ul> +<b>New Options</b> +<ul> + <li> + -open + </li> + <li> + -sort + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Improved support for old ABI dumps + </li> + <li> + Fixed a bug with auto-detection of include paths when comparing two XML descriptors + </li> + <li> + Corrected output of -debug option + </li> + <li> + Corrected -dump-system and -cmp-systems options + </li> + <li> + Other fixes + </li> +</ul> +<b>Other</b> +<ul> + <li> + Code cleaning + </li> +</ul> +<br/> + +<b>Version 1.97.5 (May 14, 2012)</b><br/> +<b>Improvements</b> +<ul> + <li> + Extended ABI dumps by source-level type declarations + </li> + <li> + Improved support for old ABI dumps + </li> + <li> + Optimization of memory usage (20%-30%) and performance (10%-20%) + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected auto-detection of a set of target headers to check/dump in -headers-only mode + </li> + <li> + Other fixes + </li> +</ul> +<b>Other</b> +<ul> + <li> + Extended regression test suite + </li> + <li> + Code cleaning + </li> +</ul> +<br/> + +<b>Version 1.97.4 (April 16, 2012)</b><br/> +<b>New Features</b> +<ul> + <li> + Added 16 new binary-compatibility rules + </li> + <li> + Added 17 new source-compatibility rules + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Added some missed typedef types to function signatures + </li> +</ul> +<b>Other</b> +<ul> + <li> + Improved support for old ABI dumps + </li> + <li> + Support for GCC 4.7 + </li> + <li> + Extended regression test suite + </li> + <li> + Code cleaning + </li> +</ul> +<br/> + +<b>Version 1.97.3 (April 03, 2012)</b><br/> +<b>Completed Tasks</b> +<ul> + <li> + Implement source-level compatibility checks + </li> + <li> + Implement 2.0 architecture + </li> +</ul> +<b>New Features</b> +<ul> + <li> + Added -browse=PROG option + </li> + <li> + Added -xml alias option for --report-format=xml + </li> + <li> + Added -binary option to generate binary-compatibility report only + </li> + <li> + Added -source option to generate source-compatibility report only + </li> + <li> + Added -bin-report-path option: path to binary-compatibility report + </li> + <li> + Added -src-report-path option: path to source-compatibility report + </li> +</ul> +<b>Other Features</b> +<ul> + <li> + Improved debug mode (-debug) + </li> + <li> + Improved mark-up of the HTML report + </li> + <li> + Improved mark-up of the HTML report + </li> + <li> + Improved support for old ABI dumps + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected ABI dumps + </li> +</ul> +<br/> + +<b>Version 1.96.8 (February 17, 2012)</b><br/> +<b>Completed Tasks</b> +<ul> + <li> + Implement XML format of compatibility report + </li> + <li> + Testing on MeeGo 1.2 Harmattan Beta2 + </li> +</ul> +<b>New Features</b> +<ul> + <li> + Added hidden statistics line to compatibility report for operating systems + </li> + <li> + Added -headers-list option + </li> + <li> + Added -lang option + </li> + <li> + Support for symbolic links in /usr/include and /usr/lib + </li> + <li> + Added "skip_include_paths" section of the XML-descriptor + </li> + <li> + Added "skip_including" section of the XML-descriptor + </li> + <li> + Added -list-affected option to create plain list of incompatible symbols + </li> + <li> + Added -quiet option to print all errors and warnings to the log file instead of stderr and stdout + </li> + <li> + Added -stdout option to print results to stdout + </li> + <li> + Added an option to check binary compatibility in the extended sense + </li> + <li> + Improve diagnostic messages for added base classes with virtual functions + </li> + <li> + Added -update option to installer + </li> + <li> + Added a relative default directory to locate modules after installation + </li> + <li> + Compatibility rate = (high+1/2*medium+1/4*low) / number of symbols + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Some symbols with extern "C" linkage are missed in -headers-only mode + </li> + <li> + Changes in global data are not detected under Windows + </li> + <li> + False negative: change global data to be "const" + </li> + <li> + Removed middle enumeration value is reported as renamed + </li> + <li> + False positive: change parameter type from "const int" to "int" + </li> + <li> + Support for old ABI dump format of ACC 1.21.6 + </li> + <li> + The tool doesn't search for included headers in /usr/lib/qt4/include/ + </li> + <li> + False Negative: Header is incompatible with itself + </li> + <li> + Check libstdc++ in -headers-only mode + </li> + <li> + Restrict checked header files in the -headers-only mode + </li> + <li> + Problem with mangled C++ functions using old ABI dump formats in -headers-only mode + </li> + <li> + Incorrect size of method pointer in ABI dumps + </li> + <li> + False negative: add/remove "register" modifier of the parameter + </li> + <li> + Incorrect WORD size when using old ABI dump format + </li> + <li> + Conflict of a static method with a function of the same name in the ABI dump + </li> + <li> + Missed right bracket of "func-ptr" type in HTML report + </li> + <li> + Incorrect report for overridden methods + </li> + <li> + False negative: override a virtual that doesn't come from a primary base + </li> + <li> + False negative: change a function parameter to be "restrict" + </li> + <li> + False negative: change a field to be "volatile" + </li> + <li> + False negative: change "const"-ness of a return value + </li> + <li> + False negative: change "volatile" attribute of a method + </li> + <li> + False positive: removed symbols with inline virtual prototype in the leaf class with default constructor + </li> +</ul> +<br/> + +<b>Version 1.94 (September 09, 2011)</b><br/> +<b>Completed Tasks</b> +<ul> + <li> + Separated regression tests into the module + </li> +</ul> +<b>New Features</b> +<ul> + <li> + Added Makefile.pl installer + </li> +</ul> +<br/> + +<b>Version 1.93.8 (September 08, 2011)</b><br/> +<b>Completed Tasks</b> +<ul> + <li> + Separated rules DB + </li> + <li> + Testing on Symbian SDK + </li> + <li> + Testing on Windows SDK + </li> + <li> + Support for OS3000 + </li> +</ul> +<b>New Features</b> +<ul> + <li> + SONAME change in the OS comparison table + </li> + <li> + Added a compatibility percentage to the OS comparison table + </li> + <li> + Added -debug option + </li> + <li> + Added listing of symbols in OS comparison table + </li> + <li> + Use zip format of dumps in Windows + </li> + <li> + Added -dump-system descriptor.xml option + </li> + <li> + Analysis of static libraries + </li> + <li> + Added -sysinfo option + </li> + <li> + Added -component option + </li> + <li> + Added -nostdinc option + </li> + <li> + Added "weakly"- and "almost"-compatible verdicts + </li> + <li> + Added "skip_namespaces" section of the library XML-descriptor + </li> + <li> + Search for modules/ directory in the system + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Missed typedefs in the ABI dump using GCC 4.4.1 + </li> + <li> + False negative: change enum member value from zero to non-zero + </li> + <li> + False negative: interchange the positions of two fields in a structure + </li> + <li> + False positive: add a field instead of padding fields + </li> + <li> + Problems with "copied" classes + </li> + <li> + Changes in "private" fields + </li> + <li> + Illegal modulus zero at abi-compliance-checker.pl + </li> + <li> + Incorrect order of include paths + </li> + <li> + Change constness of a class method + </li> + <li> + False negative: change "struct Type" to "union Type" + </li> + <li> + Change parameter type from "..." to "int" + </li> + <li> + Remove/add "const"-qualifier of a method + </li> + <li> + False negative: renamed parameters + </li> +</ul> +<b>Other</b> +<ul> + <li> + Improved debug mode + </li> +</ul> +<br/> + +<b>Version 1.23.5 (July 01, 2011)</b><br/> +<b>Bug Fixes</b> +<ul> + <li> + Corrected exit codes: 0 - compatible, 1 - incompatible, 2 - error, ... + </li> + <li> + Corrected diagnostic messages for C++ functions with changed signature + </li> + <li> + Fixed regression with C++ non-member functions + </li> + <li> + Removed false positive with overridden private methods + </li> + <li> + Corrected functionality for checking binary compatibility of operating systems + </li> + <li> + Removed false positive for removed default version of a symbol + </li> + <li> + Adapted -dump-system option for MeeGo 1.2 Harmattan + </li> + <li> + Fixed hanging execution on "#include "../../file.h" + </li> + <li> + Fixed incorrect automatic include paths + </li> +</ul> +<br/> + +<b>Version 1.23 (June 07, 2011)</b><br/> +<b>New Features</b> +<ul> + <li> + Added 42 compatibility checks (total: 83) + </li> + <li> + Improved diagnostics of compatibility problems + </li> + <li> + Opened an issue tracker + </li> + <li> + Support for cross-compilers + </li> + <li> + Ported to Mac OS X (10.5) and MS Windows (Xp, Vista, 7) + </li> + <li> + Added a viewer of "real" v-table layouts for changed C++ classes + </li> + <li> + Added functionality to check OS backward compatibility + </li> + <li> + Supports for old-version dump formats (>=1.18) + </li> + <li> + Separated versioning of dump formats + </li> + <li> + Improved design of the compatibility report + </li> + <li> + Improved performance + </li> + <li> + Support for old GCC 3.4.4 + </li> +</ul> +<b>New Options</b> +<ul> + <li> + -cross-gcc: support for cross-compilers + </li> + <li> + -sysroot: specify the alternative system root directory + </li> + <li> + -dump-system, -cmp-systems: checking OS backward compatibility + </li> + <li> + -use-dumps: check for compatibility using the intermediate dumping + </li> + <li> + -show-retval: show symbol's return value type in the report + </li> + <li> + -old-dumps: support for old-version dumps + </li> + <li> + -test-dump: test for dumping functionality + </li> + <li> + -report-path: change the location of output compatibility report + </li> + <li> + -dump-path: change the location of output ABI dump + </li> + <li> + -log1-path, -log2-path: change the location of output logs + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Reduced false positives + </li> + <li> + Support for C-headers containing C++ keywords + </li> + <li> + Corrected automatic include paths for headers + </li> +</ul> +<br/> + +<b>Version 1.21.12 (April 29, 2011)</b><br/> +<b>Bug Fixes</b> +<ul> + <li> + Corrected automatic detection of include paths for header files + </li> + <li> + Removed false positives with overridden virtual functions + </li> + <li> + Corrected processing of typedef type names, fixed potential program hangup + </li> + <li> + Added some missed problems relating to the return type changes of a function + </li> + <li> + Corrected processing of a translation unit dump generated by modern GCC versions + </li> + <li> + Corrected identifying of inline functions (using the -fkeep-inline-functions GCC option) + </li> + <li> + Corrected parser for C++: analysis of const global data and functions inside a namespace + </li> + <li> + Corrected names and v-table checks for template types + </li> + <li> + Corrected checks for changes in enumerations + </li> + <li> + Corrected ABI dumping and sorting of dumps + </li> + <li> + Corrected analysis of added/removed virtual functions + </li> + <li> + Corrected help message and documentation + </li> + <li> + Documentation has been moved to "doc/" subdirectory + </li> + <li> + Using File::Temp for storing temporary files + </li> + <li> + Support for latest GCC 4.6.0 and old GCC v3.x series + </li> + <li> + Fixed infinite loop finding the path for "which" command in the system + </li> + <li> + Corrected distinction of descriptor kinds (headers, libraries, directories and XML-descriptors) + </li> + <li> + Corrected processing of "include_paths" section of the XML-descriptor + </li> +</ul> +<br/> + +<b>Version 1.21 (August 19, 2010)</b><br/> +<b>New Features</b> +<ul> + <li> + Added -check-implementation option: compare disassembled binary code to detect changes in the interface implementation + </li> + <li> + Added -objects-only option: compare shared objects without header files + </li> + <li> + Added -v1 and -v2 options: specify version number outside the descriptor + </li> + <li> + Improved help message + </li> + <li> + Improved performance of the tool + </li> + <li> + Removed template instances and stdc++ interfaces from the report (C++) + </li> + <li> + Added README.html and CHANGES.html to the package + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected ABI compatibility report + </li> + <li> + Corrected interface names and versions in the report + </li> + <li> + Corrected number of problems in report summary + </li> + <li> + Corrected ABI dump + </li> +</ul> +<br/> + +<b>Version 1.20 (August 30, 2010)</b><br/> +<b>New Features</b> +<ul> + <li> + Added "defines" section of the library descriptor: this section allows to add defines at the headers compiling stage + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected reports about added/withdrawn members in the structure types and added/withdrawn parameters + </li> + <li> + Corrected report about added/withdrawn virtual functions if -headers_only option specified + </li> + <li> + Corrected processing of header paths containing special characters + </li> +</ul> +<br/> + +<b>Version 1.19 (July 22, 2010)</b><br/> +<b>New Features</b> +<ul> + <li> + Added -library_full_name option to display full library name in title of the report + </li> + <li> + Added -relpath option to replace the {RELPATH} in the descriptor for ABI dumping + </li> + <li> + Added "skip_libs" section of the library descriptor: this section contains a list of shared objects and/or directories with shared objects that should not be processed + </li> + <li> + Improved performance on big libraries + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Removed duplicated problems from the report + </li> + <li> + Corrected names of the template instances + </li> + <li> + Corrected checking of reference type changes + </li> + <li> + Corrected titles in the report + </li> + <li> + Corrected size of some array types + </li> + <li> + Corrected checking of added/withdrawn members in the structure types with reserved members + </li> + <li> + Corrected checking of added/withdrawn parameters + </li> +</ul> +<br/> + +<b>Version 1.18 (June 25, 2010)</b><br/> +<b>New Features</b> +<ul> + <li> + Added -relpath1 and -relpath2 options to replace the {RELPATH} in the descriptors; old option -relpath was removed + </li> + <li> + Added "add_include_paths" section of the library descriptor: this section contains a list of include paths that should be added to the automatically detected include paths + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Added some previously missed compatibility problems in the report + </li> + <li> + Corrected techniques for auto-detection of header file dependencies (include paths) + </li> + <li> + Removed problems relating to the changes in the temporary header files + </li> + <li> + Corrected interface signatures in the report + </li> + <li> + Corrected checking of added/withdrawn parameters + </li> + <li> + Corrected changes in the virtual tables of the libraries with symbol versioning + </li> + <li> + Corrected checking of complex namespaces changes (C++) + </li> + <li> + Added namespaces information to the ABI dump + </li> +</ul> +<br/> + +<b>Version 1.17.2 (June 16, 2010)</b><br/> +<b>Bug Fixes</b> +<ul> + <li> + Fixed -separately option + </li> + <li> + Corrected permissions of LICENSE file + </li> + <li> + Corrected tool description + </li> +</ul> +<br/> + +<b>Version 1.17.1 (June 09, 2010)</b><br/> +<b>New Features</b> +<ul> + <li> + Added -relpath option for adding prefixes to the paths in the library descriptor + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected checking of added/withdrawn parameters + </li> + <li> + Corrected processing of mixed C/C++ header sets + </li> + <li> + Corrected checking of parameter type changes + </li> +</ul> +<br/> + +<b>Version 1.17 (June 08, 2010)</b><br/> +<b>New Features</b> +<ul> + <li> + Visualizing of the serious changes (added/withdrawn parameters) in the interface signature + </li> + <li> + Recursive analysis of constant changes + </li> + <li> + Separated stderr and stdout streams of the tool + </li> + <li> + Added "skip_constants" section of the library descriptor to skip checking of some constants + </li> + <li> + Added -params option to add function parameter names to the report + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected analysis of virtual table layout changes + </li> + <li> + Corrected analysis of parameter type changes + </li> + <li> + Corrected complex array type names + </li> + <li> + Corrected typedef names + </li> + <li> + Corrected analysis of structure layout changes + </li> + <li> + Fixed tool hanging on some C++ headers (with many namespaces) + </li> + <li> + Corrected analysis of Glibc headers + </li> + <li> + Corrected analysis of library language changes (if added some C++ headers) + </li> + <li> + Corrected descriptions of some compatibility problems + </li> + <li> + Corrected analysis of added/withdrawn parameters in C headers + </li> +</ul> +<br/> + +<b>Version 1.16 (May 05, 2010)</b><br/> +<b>New Features</b> +<ul> + <li> + Added -strict option for treating all compatibility warnings as problems + </li> + <li> + Added -dumpversion option for printing tool version and don't do anything else + </li> + <li> + Ignoring hidden .svn, .git, .bzr, .hg, and CVS directories + </li> + <li> + Improved header files sorting for protecting from compilation errors on the intermediate phase of temporary header file compilation + </li> + <li> + Improved techniques for auto-detection of header file dependencies (include paths) + </li> + <li> + Ignoring problems related to changes of constants (defines) describing library version (*_VERSION_*, *_COPYRIGHT_* and other) + </li> + <li> + New internal test cases + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Checking of some previously missed C++ namespaces + </li> + <li> + Removed hidden "void const** __vtt_parm" parameters from signatures of some constructors + </li> + <li> + Corrected dumping of C++ classes ABI + </li> + <li> + Corrected checking of pure virtual destructors + </li> + <li> + Removed unnecessary built-in constants from the ABI dump + </li> +</ul> +<br/> + +<b>Version 1.15 (March 26, 2010)</b><br/> +<b>New Features</b> +<ul> + <li> + The license was changed to dual GNU GPL and LGPL + </li> + <li> + Added "skip_headers" section of the library descriptor + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected processing of "include_paths" section of the library descriptor + </li> + <li> + Corrected processing of relative paths in the "headers" and "include_paths" sections of the descriptor + </li> + <li> + Directory with temporary files renamed from "temp" to hidden ".tmp_dir" + </li> + <li> + Corrected processing of shared object dependencies + </li> + <li> + Corrected processing of some previously missed functions and conversion operators in C++ + </li> + <li> + Corrected internal test suite + </li> + <li> + Corrected some error messages + </li> +</ul> +<br/> + +<b>Version 1.14 (March 03, 2010)</b><br/> +<b>New Features</b> +<ul> + <li> + Added techniques to auto-detect dependencies of a header file (include paths); providing of "include_paths" section of the descriptor is not necessary for now + </li> + <li> + Ported to FreeBSD and Haiku + </li> + <li> + Added check for gcc/g++ version (>=3.0.0) + </li> + <li> + Added sorting of interface problems by namespace in the report (C++) + </li> + <li> + Improved internal test suite + </li> + <li> + Added log for describing tool actions and occurred errors + </li> + <li> + Added exit error code (high/medium risk for ABI break) + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected ABI dumping + </li> + <li> + Corrected styles of the report + </li> +</ul> +<br/> + +<b>Version 1.13 (February 16, 2010)</b><br/> +<b>New Features</b> +<ul> + <li> + Added -version option + </li> + +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected processing of tab characters in the descriptor + </li> + <li> + Corrected help message + </li> + <li> + Corrected descriptor template structure + </li> + <li> + Corrected error and warning messages + </li> + <li> + Corrected processing of shared object dependencies + </li> +</ul> +<br/> + +<b>Version 1.12 (December 04, 2009)</b><br/> +<b>New Features</b> +<ul> + <li> + New help message + </li> + <li> + Highlighting of [in-charge], [not-in-charge] constructors and destructors in the report was improved + </li> + <li> + New option -time for enabling time measurements + </li> + <li> + New internal test cases + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected classification of compatibility problems in the report + </li> + <li> + Reduced priority of problems related to changes in a method's object + </li> + <li> + Corrected complex template type names + </li> +</ul> +<br/> + +<b>Version 1.11 (November 10, 2009)</b><br/> +<b>New Features</b> +<ul> + <li> + Added -app option to check portability of applications to the new library version + </li> + <li> + Memory usage decreased twice + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Corrected checking of added middle structure members + </li> + <li> + Corrected names of template types (with intrinsic, bool and string parameters) + </li> + <li> + Corrected highlighting of function signatures in the report + </li> +</ul> +<br/> + +<b>Version 1.10 (November 02, 2009)</b><br/> +<b>New Features</b> +<ul> + <li> + Checking added/dropped function parameters (C language only) + </li> + <li> + Improved design of the report + </li> + <li> + New internal test cases + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Incorrect checking of redefined virtual functions and differences in parameter types + </li> + <li> + More careful checking of withdrawn interfaces using shared library dependencies + </li> +</ul> +<br/> + +<b>Version 1.9 (October 12, 2009)</b><br/> +<b>Improvements</b> +<ul> + <li> + Improved design of ABI compliance report + </li> + <li> + Improved algorithms of checking parameter/field type change + </li> + <li> + New internal test cases + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Fixed incorrect names of typedefs and function pointer types + </li> + <li> + Checking of some previously missed C++ functions + </li> + <li> + Removed some false positives from the report (for anon-types) + </li> +</ul> +<br/> + +<b>Version 1.8 (September 29, 2009)</b><br/> +<b>New Features</b> +<ul> + <li> + Added ability to specify a file with a list of interfaces that should be checked + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Size of ABI info dumps have been reduced through removing of unnecessary information + </li> + <li> + Incorrect names of template instances and function pointer types + </li> + <li> + Incorrect positions of function parameters in the "Interface Problems" section of the report + </li> + <li> + Removed some false positives from the report + </li> + <li> + Incorrect handling of special symbols in the paths to header files and shared objects + </li> +</ul> +<br/> + +<b>Version 1.7 (September 11, 2009)</b><br/> +<b>New Features</b> +<ul> + <li> + Checking of incorrect symbols versioning + </li> + <li> + Checking the values of defines (constants) + </li> + <li> + Ability to check header files without shared objects; It is easy to run, but may provide a low quality report with a lot of false positives and without detecting of added/withdrawn interfaces + </li> + <li> + Number of checked interfaces and data types in the report + </li> + <li> + Added tests for checking new features + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Incorrect processing of duplicated headers in the input set (headers with the same name but different paths) + </li> + <li> + Incorrect header files include order + </li> + <li> + Sorting in the ABI dumps + </li> + <li> + Incorrect processing of redefined virtual methods + </li> + <li> + Incorrect processing of anon types + </li> + <li> + Absence of some necessary information about C++ functions in the ABI dumps + </li> +</ul> +<br/> + +<b>Version 1.6 (August 31, 2009)</b><br/> +<b>Bug Fixes</b> +<ul> + <li> + Corrected processing of relative paths in the library descriptor + </li> + <li> + Display machine hardware name instead of processor type in the report + </li> + <li> + Fixed grammar/spelling errors + </li> + <li> + Renamed "internal_interfaces" section of the library descriptor to "skip_interfaces" + </li> + <li> + Cosmetic changes in the code + </li> +</ul> +<br/> + +<b>Version 1.5 (August 25, 2009)</b><br/> +<b>Bug Fixes</b> +<ul> + <li> + Absent information about opaque types and internal interfaces has been added to the ABI dump + </li> + <li> + Fixed style of the report + </li> + <li> + Fixed grammar/spelling + </li> + <li> + Renamed "internal_functions" section of the library descriptor to "internal_interfaces" + </li> + <li> + Renamed outptu ABI dump to "*.abi.tar.gz" (previously it was "*.info.tar.gz") + </li> + <li> + Corrected interface names in the report (for -separately option) + </li> +</ul> +<br/> + +<b>Version 1.4 (August 18, 2009)</b><br/> +<b>Improvements</b> +<ul> + <li> + Added ability to check ABI compliance of library versions located on different machines + </li> + <li> + Header files checking mode by default has been changed: checking all header files together instead of separate checking + </li> +</ul> +<b>Bug Fixes</b> +<ul> + <li> + Incorrect description for affected interfaces + </li> + <li> + Incorrect virtual table checking + </li> +</ul> +<br/> + +<b>Version 1.3 (August 14, 2009)</b><br/> +<b>Bug Fixes</b> +<ul> + <li> + Incorrect number of binary compatibility problems in the report summary + </li> + <li> + Incorrect design of problem descriptions in the report + </li> +</ul> +<br/> + +<b>Version 1.1 (August 06, 2009)</b><br/> +<b>Improvements</b> +<ul> + <li> + Design of the report has been greatly improved + </li> +</ul> +<br/> + +<b>Version 1.0 (July 31, 2009)</b><br/> +Initial version of the tool. + +<div class="footer"> + get the source code on GitHub : <a href="https://github.com/lvc/abi-compliance-checker">lvc/abi-compliance-checker</a> +</div> + +<br/> +<br/> + +</div> +</body> +</html> diff --git a/doc/Changes.html b/doc/Changes.html deleted file mode 100644 index 5c5c088..0000000 --- a/doc/Changes.html +++ /dev/null @@ -1,1091 +0,0 @@ - -<!DOCTYPE html> -<html lang="en" dir="ltr" class="client-nojs"> -<head> -<title>ABI Compliance Checker - Change Log</title> -<meta charset="UTF-8" /> -<meta name="generator" content="MediaWiki 1.18.1" /> -<link rel="shortcut icon" href="/favicon.ico" /> -<link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="ISP_RAS (en)" /> -<link rel="EditURI" type="application/rsd+xml" href="http://ispras.linuxbase.org/api.php?action=rsd" /> -<link rel="alternate" type="application/atom+xml" title="ISP_RAS Atom feed" href="/index.php?title=Special:RecentChanges&feed=atom" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=mediawiki.legacy.commonPrint%2Cshared%7Cskins.monobook&only=styles&skin=monobook&*" /> -<!--[if lt IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE50Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE55Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 6]><link rel="stylesheet" href="/skins/monobook/IE60Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 7]><link rel="stylesheet" href="/skins/monobook/IE70Fixes.css?303" media="screen" /><![endif]--><meta name="ResourceLoaderDynamicStyles" content="" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=site&only=styles&skin=monobook&*" /> -<style>a:lang(ar),a:lang(ckb),a:lang(fa),a:lang(kk-arab),a:lang(mzn),a:lang(ps),a:lang(ur){text-decoration:none}a.new,#quickbar a.new{color:#ba0000} - -/* cache key: rasispdb:resourceloader:filter:minify-css:4:c88e2bcd56513749bec09a7e29cb3ffa */ -</style> -<script src="/load.php?debug=false&lang=en&modules=startup&only=scripts&skin=monobook&*"></script> -<script>if(window.mw){ - mw.config.set({"wgCanonicalNamespace": "", "wgCanonicalSpecialPageName": false, "wgNamespaceNumber": 0, "wgPageName": "ABI_compliance_checker_Downloads", "wgTitle": "ABI Compliance Checker Downloads", "wgCurRevisionId": 8346, "wgArticleId": 2293, "wgIsArticle": true, "wgAction": "view", "wgUserName": null, "wgUserGroups": ["*"], "wgCategories": ["ABI Compliance Checker"], "wgBreakFrames": false, "wgRestrictionEdit": [], "wgRestrictionMove": []}); -} -</script><script>if(window.mw){ - mw.loader.load(["mediawiki.page.startup"]); -} -</script> -</head> -<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-ABI_compliance_checker_Downloads action-view skin-monobook"> -<div id="globalWrapper"> -<div id="column-content"><div id="content"> - <a id="top"></a> - - <h1 id="firstHeading" class="firstHeading">ABI Compliance Checker - Change Log</h1> - <div id="bodyContent"> - <div id="siteSub"></div> - <div id="contentSub"></div> - - <!-- start content --> -<div lang="en" dir="ltr" class="mw-content-ltr"><p>Thanks to all for reporting issues so the tool can continue to be improved! -</p> -<table id="toc" class="toc"><tr><td><div id="toctitle"><h2>Contents</h2></div> -<ul> -<li class="toclevel-1 tocsection-1"><a href="#Version_1.99.9_.28January_23.2C_2014.29"><span class="tocnumber">1</span> <span class="toctext">Version 1.99.9 (January 23, 2014)</span></a></li> -<li class="toclevel-1 tocsection-2"><a href="#Version_1.99.8.5_.28October_03.2C_2013.29"><span class="tocnumber">2</span> <span class="toctext">Version 1.99.8.5 (October 03, 2013)</span></a></li> -<li class="toclevel-1 tocsection-3"><a href="#Version_1.99.7_.28July_01.2C_2013.29"><span class="tocnumber">3</span> <span class="toctext">Version 1.99.7 (July 01, 2013)</span></a></li> -<li class="toclevel-1 tocsection-4"><a href="#Version_1.99.1_.28June_07.2C_2013.29"><span class="tocnumber">4</span> <span class="toctext">Version 1.99.1 (June 07, 2013)</span></a></li> -<li class="toclevel-1 tocsection-5"><a href="#Version_1.99_.28May_24.2C_2013.29"><span class="tocnumber">5</span> <span class="toctext">Version 1.99 (May 24, 2013)</span></a></li> -<li class="toclevel-1 tocsection-6"><a href="#Version_1.98.8_.28February_07.2C_2013.29"><span class="tocnumber">6</span> <span class="toctext">Version 1.98.8 (February 07, 2013)</span></a></li> -<li class="toclevel-1 tocsection-7"><a href="#Version_1.98.7_.28December_14.2C_2012.29"><span class="tocnumber">7</span> <span class="toctext">Version 1.98.7 (December 14, 2012)</span></a></li> -<li class="toclevel-1 tocsection-8"><a href="#Version_1.98.6_.28December_04.2C_2012.29"><span class="tocnumber">8</span> <span class="toctext">Version 1.98.6 (December 04, 2012)</span></a></li> -<li class="toclevel-1 tocsection-9"><a href="#Version_1.98.5_.28November_30.2C_2012.29"><span class="tocnumber">9</span> <span class="toctext">Version 1.98.5 (November 30, 2012)</span></a></li> -<li class="toclevel-1 tocsection-10"><a href="#Version_1.98.4_.28October_18.2C_2012.29"><span class="tocnumber">10</span> <span class="toctext">Version 1.98.4 (October 18, 2012)</span></a></li> -<li class="toclevel-1 tocsection-11"><a href="#Version_1.98.3_.28July_19.2C_2012.29"><span class="tocnumber">11</span> <span class="toctext">Version 1.98.3 (July 19, 2012)</span></a></li> -<li class="toclevel-1 tocsection-12"><a href="#Version_1.98.2_.28June_26.2C_2012.29"><span class="tocnumber">12</span> <span class="toctext">Version 1.98.2 (June 26, 2012)</span></a></li> -<li class="toclevel-1 tocsection-13"><a href="#Version_1.98.1_.28June_18.2C_2012.29"><span class="tocnumber">13</span> <span class="toctext">Version 1.98.1 (June 18, 2012)</span></a></li> -<li class="toclevel-1 tocsection-14"><a href="#Version_1.98.0_.28June_14.2C_2012.29"><span class="tocnumber">14</span> <span class="toctext">Version 1.98.0 (June 14, 2012)</span></a></li> -<li class="toclevel-1 tocsection-15"><a href="#Version_1.97.8_.28June_08.2C_2012.29"><span class="tocnumber">15</span> <span class="toctext">Version 1.97.8 (June 08, 2012)</span></a></li> -<li class="toclevel-1 tocsection-16"><a href="#Version_1.97.5_.28May_14.2C_2012.29"><span class="tocnumber">16</span> <span class="toctext">Version 1.97.5 (May 14, 2012)</span></a></li> -<li class="toclevel-1 tocsection-17"><a href="#Version_1.97.4_.28April_16.2C_2012.29"><span class="tocnumber">17</span> <span class="toctext">Version 1.97.4 (April 16, 2012)</span></a></li> -<li class="toclevel-1 tocsection-18"><a href="#Version_1.97.3_.28April_03.2C_2012.29"><span class="tocnumber">18</span> <span class="toctext">Version 1.97.3 (April 03, 2012)</span></a></li> -<li class="toclevel-1 tocsection-19"><a href="#Version_1.96.8_.28February_17.2C_2012.29"><span class="tocnumber">19</span> <span class="toctext">Version 1.96.8 (February 17, 2012)</span></a></li> -<li class="toclevel-1 tocsection-20"><a href="#Version_1.94_.28September_09.2C_2011.29"><span class="tocnumber">20</span> <span class="toctext">Version 1.94 (September 09, 2011)</span></a></li> -<li class="toclevel-1 tocsection-21"><a href="#Version_1.93.8_.28September_08.2C_2011.29"><span class="tocnumber">21</span> <span class="toctext">Version 1.93.8 (September 08, 2011)</span></a></li> -<li class="toclevel-1 tocsection-22"><a href="#Version_1.23.5_.28July_01.2C_2011.29"><span class="tocnumber">22</span> <span class="toctext">Version 1.23.5 (July 01, 2011)</span></a></li> -<li class="toclevel-1 tocsection-23"><a href="#Version_1.23_.28June_07.2C_2011.29"><span class="tocnumber">23</span> <span class="toctext">Version 1.23 (June 07, 2011)</span></a></li> -<li class="toclevel-1 tocsection-24"><a href="#Version_1.21.12_.28April_29.2C_2011.29"><span class="tocnumber">24</span> <span class="toctext">Version 1.21.12 (April 29, 2011)</span></a></li> -<li class="toclevel-1 tocsection-25"><a href="#Version_1.21_.28August_19.2C_2010.29"><span class="tocnumber">25</span> <span class="toctext">Version 1.21 (August 19, 2010)</span></a></li> -<li class="toclevel-1 tocsection-26"><a href="#Version_1.20_.28August_30.2C_2010.29"><span class="tocnumber">26</span> <span class="toctext">Version 1.20 (August 30, 2010)</span></a></li> -<li class="toclevel-1 tocsection-27"><a href="#Version_1.19_.28July_22.2C_2010.29"><span class="tocnumber">27</span> <span class="toctext">Version 1.19 (July 22, 2010)</span></a></li> -<li class="toclevel-1 tocsection-28"><a href="#Version_1.18_.28June_25.2C_2010.29"><span class="tocnumber">28</span> <span class="toctext">Version 1.18 (June 25, 2010)</span></a></li> -<li class="toclevel-1 tocsection-29"><a href="#Version_1.17.2_.28June_16.2C_2010.29"><span class="tocnumber">29</span> <span class="toctext">Version 1.17.2 (June 16, 2010)</span></a></li> -<li class="toclevel-1 tocsection-30"><a href="#Version_1.17.1_.28June_09.2C_2010.29"><span class="tocnumber">30</span> <span class="toctext">Version 1.17.1 (June 09, 2010)</span></a></li> -<li class="toclevel-1 tocsection-31"><a href="#Version_1.17_.28June_08.2C_2010.29"><span class="tocnumber">31</span> <span class="toctext">Version 1.17 (June 08, 2010)</span></a></li> -<li class="toclevel-1 tocsection-32"><a href="#Version_1.16_.28May_05.2C_2010.29"><span class="tocnumber">32</span> <span class="toctext">Version 1.16 (May 05, 2010)</span></a></li> -<li class="toclevel-1 tocsection-33"><a href="#Version_1.15_.28March_26.2C_2010.29"><span class="tocnumber">33</span> <span class="toctext">Version 1.15 (March 26, 2010)</span></a></li> -<li class="toclevel-1 tocsection-34"><a href="#Version_1.14_.28March_03.2C_2010.29"><span class="tocnumber">34</span> <span class="toctext">Version 1.14 (March 03, 2010)</span></a></li> -<li class="toclevel-1 tocsection-35"><a href="#Version_1.13_.28February_16.2C_2010.29"><span class="tocnumber">35</span> <span class="toctext">Version 1.13 (February 16, 2010)</span></a></li> -<li class="toclevel-1 tocsection-36"><a href="#Version_1.12_.28December_04.2C_2009.29"><span class="tocnumber">36</span> <span class="toctext">Version 1.12 (December 04, 2009)</span></a></li> -<li class="toclevel-1 tocsection-37"><a href="#Version_1.11_.28November_10.2C_2009.29"><span class="tocnumber">37</span> <span class="toctext">Version 1.11 (November 10, 2009)</span></a></li> -<li class="toclevel-1 tocsection-38"><a href="#Version_1.10_.28November_02.2C_2009.29"><span class="tocnumber">38</span> <span class="toctext">Version 1.10 (November 02, 2009)</span></a></li> -<li class="toclevel-1 tocsection-39"><a href="#Version_1.9_.28October_12.2C_2009.29"><span class="tocnumber">39</span> <span class="toctext">Version 1.9 (October 12, 2009)</span></a></li> -<li class="toclevel-1 tocsection-40"><a href="#Version_1.8_.28September_29.2C_2009.29"><span class="tocnumber">40</span> <span class="toctext">Version 1.8 (September 29, 2009)</span></a></li> -<li class="toclevel-1 tocsection-41"><a href="#Version_1.7_.28September_11.2C_2009.29"><span class="tocnumber">41</span> <span class="toctext">Version 1.7 (September 11, 2009)</span></a></li> -<li class="toclevel-1 tocsection-42"><a href="#Version_1.6_.28August_31.2C_2009.29"><span class="tocnumber">42</span> <span class="toctext">Version 1.6 (August 31, 2009)</span></a></li> -<li class="toclevel-1 tocsection-43"><a href="#Version_1.5_.28August_25.2C_2009.29"><span class="tocnumber">43</span> <span class="toctext">Version 1.5 (August 25, 2009)</span></a></li> -<li class="toclevel-1 tocsection-44"><a href="#Version_1.4_.28August_18.2C_2009.29"><span class="tocnumber">44</span> <span class="toctext">Version 1.4 (August 18, 2009)</span></a></li> -<li class="toclevel-1 tocsection-45"><a href="#Version_1.3_.28August_14.2C_2009.29"><span class="tocnumber">45</span> <span class="toctext">Version 1.3 (August 14, 2009)</span></a></li> -<li class="toclevel-1 tocsection-46"><a href="#Version_1.2_.28August_07.2C_2009.29"><span class="tocnumber">46</span> <span class="toctext">Version 1.2 (August 07, 2009)</span></a></li> -<li class="toclevel-1 tocsection-47"><a href="#Version_1.1_.28August_06.2C_2009.29"><span class="tocnumber">47</span> <span class="toctext">Version 1.1 (August 06, 2009)</span></a></li> -<li class="toclevel-1 tocsection-48"><a href="#Version_1.0_.28July_31.2C_2009.29"><span class="tocnumber">48</span> <span class="toctext">Version 1.0 (July 31, 2009)</span></a></li> -</ul> -</td></tr></table> -<h2> <span class="mw-headline" id="Version_1.99.9_.28January_23.2C_2014.29"> Version 1.99.9 (January 23, 2014) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/archive/1.99.9.tar.gz">abi-compliance-checker-1.99.9.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p> -<ul><li> <b>New Options</b> -<ul><li> <a href="Options.html" title="ABI Compliance Checker Options">-skip-internal</a>: do not check internal interfaces matched by the pattern -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Fixed duplicated entries in the XML report -</li><li> Reduced size of the XML report -</li><li> Fixed duplicated problems related to changed size of a global data -</li><li> Options -v1 and -v2 can now be used when comparing ABI dumps to change library versions shown in the report -</li><li> Fixed false positives with the size change of a template instance type -</li><li> Fixed false positives with the change of a parameter/field type name -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.99.8.5_.28October_03.2C_2013.29"> Version 1.99.8.5 (October 03, 2013) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/archive/1.99.8.5.tar.gz">abi-compliance-checker-1.99.8.5.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Optimized performance and memory usage (up to 90%) on input objects with a huge number of changes and deep data type trees (e.g. Linux kernel) -</li><li> Partial support for GCC 4.8.{0-1}, waiting for a fix for the bug <a rel="nofollow" class="external text" href="http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57850">57850</a> in the next GCC versions -</li><li> Support for incomplete ABI dumps -</li></ul> -</li></ul> -<ul><li> <b>New Options</b> -<ul><li> <a href="Options.html" title="ABI Compliance Checker Options">-affected-limit</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-cpp-incompatible</a> -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Fixed identification of template constructors and destructors -</li><li> Do not show "this" first argument of methods in the report -</li><li> Corrected descriptions of affected symbols in the report -</li><li> Fixed false alarms on changed offset of parameters -</li><li> Do not hang on class A<N>:public A<N-1> -</li><li> Corrected identification of header files in the include_preamble -</li><li> Corrected comparison of function pointer types -</li><li> Corrected rule Global_Data_Size -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Code refactoring -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.99.7_.28July_01.2C_2013.29"> Version 1.99.7 (July 01, 2013) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/archive/1.99.7.tar.gz">abi-compliance-checker-1.99.7.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Added missed fields of template instance types to the ABI dump -</li><li> Improved support for old ABI dumps -</li><li> Added Struct_Field_Size_Increased rule -</li><li> Support for vector types (GCC extension) -</li><li> Removed duplicates from the ABI dump -</li><li> Corrected visualization of v-table content in the report -</li><li> Corrected identification of target headers -</li><li> Corrected source-compatibility check -</li><li> Performance optimization (5%) -</li></ul> -</li></ul> -<ul><li> <b>New Options</b> -<ul><li> <a href="Options.html" title="ABI Compliance Checker Options">-check</a> - to check completeness of the ABI dump -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Fixed default arguments of methods (broken in 1.99.1 due to added "this" parameter) -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Extended test suite -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.99.1_.28June_07.2C_2013.29"> Version 1.99.1 (June 07, 2013) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/archive/1.99.1.tar.gz">abi-compliance-checker-1.99.1.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Support for <a rel="nofollow" class="external text" href="https://github.com/lvc/abi-dumper">ABI Dumper</a> 0.97 -</li><li> Show added/removed inline virtual functions in the binary compatibility report -</li><li> Added "this" hidden parameter to non-static class methods in the ABI dump -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Fixed XmlDump module -</li><li> Fixed CallConv module -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Support for old ABI dumps -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.99_.28May_24.2C_2013.29"> Version 1.99 (May 24, 2013) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/archive/1.99.tar.gz">abi-compliance-checker-1.99.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Support for <a rel="nofollow" class="external text" href="https://github.com/lvc/abi-dumper">ABI Dumper</a> 0.95 -</li><li> Added 14 binary-compatibility rules -</li><li> Added 10 source-compatibility rules -</li><li> Improved model of type alignment -</li><li> Changed version of ABI dump format to 3.0 -</li><li> Added _vptr member to virtual classes -</li><li> Added constants defined by GCC to ABI dump -</li><li> Improved analysis of constants -</li></ul> -</li></ul> -<ul><li> <b>New Options</b> -<ul><li> <a href="Options.html" title="ABI Compliance Checker Options">-skip-symbols</a> -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Increased severity of Field_Became_Non_Mutable rule -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Support for old ABI dumps -</li><li> Extended test suite (+11 test cases) -</li><li> Code cleaning -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.98.8_.28February_07.2C_2013.29"> Version 1.98.8 (February 07, 2013) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/archive/1.98.8.tar.gz">abi-compliance-checker-1.98.8.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Show added and removed constants (#defines) in the report -</li><li> Show changes in unnamed enumerations -</li><li> Avoid false alarm about renamed field if old name of this field is defined to new (SC) -</li><li> Recursive comparing of structured data types in *_Format rules -</li><li> Added Typedef_BaseType_Format rule to check format changes in the typedef base type -</li></ul> -</li></ul> -<ul><li> <b>New Options</b> -<ul><li> <a href="Options.html" title="ABI Compliance Checker Options">-tolerant</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-tolerance</a> -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Increased severity of Parameter_BaseType_And_Size BC rule (Low to Medium) -</li><li> Increased severity of Added_Field SC rule (Safe to Low) -</li><li> Corrected handling of the tool error codes in the test suite -</li><li> Corrected handling of relative paths in descriptor options -</li><li> Skipping linker-related options in gcc_options option of the descriptor -</li><li> Corrected internal mangler for C++ functions -</li><li> Corrected conditions for enabling of C++ compatibility mode -</li><li> Corrected handling of C++ keywords in C-code -</li><li> Corrected <a href="Options.html" title="ABI Compliance Checker Options">-extended</a> option -</li><li> Corrected Typedef_BaseType rule -</li><li> Corrected parsing of default function arguments -</li><li> Do not check presence of archive utilities if not used -</li><li> Other fixes -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Extended test suite -</li><li> Code cleaning -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.98.7_.28December_14.2C_2012.29"> Version 1.98.7 (December 14, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/archive/1.98.7.tar.gz">abi-compliance-checker-1.98.7.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Extended extra info dumped by <a href="Options.html" title="ABI Compliance Checker Options">-extra-info</a> option -</li><li> Extended additional info dumped by <a href="Options.html" title="ABI Compliance Checker Options">-extra-dump</a> option -</li><li> Added specifiers for structs, unions and enums in the report and ABI dump -</li><li> Improved support for old ABI dumps -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected <a href="Options.html" title="ABI Compliance Checker Options">-debug</a> option -</li><li> Corrected creating of archives with ABI dumps -</li><li> Corrected parsing of includes in header files -</li><li> Corrected processing of undefined symbols -</li><li> Corrected <a href="Options.html" title="ABI Compliance Checker Options">-app</a> option -</li><li> Corrected processing of default paths to system libraries -</li><li> Corrected Makefile -</li><li> Other fixes -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Code cleaning and refactoring -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.98.6_.28December_04.2C_2012.29"> Version 1.98.6 (December 04, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.98.6.tar.gz">abi-compliance-checker-1.98.6.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Extended <a href="Options.html" title="ABI Compliance Checker Options">-extra-info</a> and <a href="Options.html" title="ABI Compliance Checker Options">-extra-dump</a> options -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected processing of input XML descriptor -</li><li> Corrected "Parameter_Default_Value_Removed" rule -</li><li> Other fixes -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Code cleaning -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.98.5_.28November_30.2C_2012.29"> Version 1.98.5 (November 30, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.98.5.tar.gz">abi-compliance-checker-1.98.5.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Support for Mac OS X 10.8 -</li><li> Support for OpenBSD -</li><li> Support for old GCC versions <= 4.2 -</li><li> Added "throw" and "weak" attributes of methods to ABI dump -</li></ul> -</li></ul> -<ul><li> <b>New Options</b> -<ul><li> <a href="Options.html" title="ABI Compliance Checker Options">-extra-info</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-extra-dump</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-force</a> -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected order of user-defined include paths -</li><li> Corrected internal C++ mangler -</li><li> Removed false positives of the "Parameter_Type_Format" rule -</li><li> Other fixes -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Extended test suite -</li><li> Code cleaning -</li><li> Docs cleaning -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.98.4_.28October_18.2C_2012.29"> Version 1.98.4 (October 18, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.98.4.tar.gz">abi-compliance-checker-1.98.4.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Optimization of memory usage (5%-10%) and performance (5%-10%) -</li><li> Added "Used Reserved Field" rule of binary compatibility analysis -</li><li> Improved design of the operating system compatibility report -</li><li> Added meta descriptors for 334 libraries -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Fixed an issue with diagnostics of added virtual functions -</li><li> Corrected the list of functions affected by the compatibility problem -</li><li> Avoid false alarm about removed function if this function became macro (SC) -</li><li> Corrected parser of C header files -</li><li> Other fixes -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Extended test suite -</li><li> Code cleaning -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.98.3_.28July_19.2C_2012.29"> Version 1.98.3 (July 19, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.98.3.tar.gz">abi-compliance-checker-1.98.3.tar.gz</a><br /> -</p><p><b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>New Features</b> -<ul><li> Implemented a model of calling conventions on x86 and x86_64 -</li><li> Improved diagnostics of changes in function parameters and return value (distribution on registers and stack) -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected parser of C++ header files to detect non-member functions inside namespaces -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Added requirement for Ctags (5.8 or newer) -</li><li> Code cleaning -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.98.2_.28June_26.2C_2012.29"> Version 1.98.2 (June 26, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.98.2.tar.gz">abi-compliance-checker-1.98.2.tar.gz</a><br /> -<b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>New Features</b> -<ul><li> Support for reading ABI dumps in XML format -</li><li> Automatic enabling of c++0x support if needed to compile headers -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected XML and Perl (default) formats of ABI dumps -</li><li> Improved support for old ABI dumps -</li><li> Improved <a href="Options.html" title="ABI Compliance Checker Options">-dump-system</a> option -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Improved documentation -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.98.1_.28June_18.2C_2012.29"> Version 1.98.1 (June 18, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.98.1.tar.gz">abi-compliance-checker-1.98.1.tar.gz</a><br /> -<b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release. -</p> -<ul><li> <b>Bug Fixes</b> -<ul><li> Removed symbols marked as LOCAL in a shared library from lists of added/removed symbols in source-compatibility report -</li><li> Fixed a false positive with some removed extern "C" symbols in source-compatibility report -</li><li> Fixed a bug with removed debug/ directory when using <a href="Options.html" title="ABI Compliance Checker Options">-use-dumps</a> and <a href="Options.html" title="ABI Compliance Checker Options">-debug</a> options together -</li><li> Added support for skip_including section of target system XML descriptors (modules/Targets) used by <a href="Options.html" title="ABI Compliance Checker Options">-dump-system</a> option -</li><li> Extended XML ABI dumps by size attribute of library symbols -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.98.0_.28June_14.2C_2012.29"> Version 1.98.0 (June 14, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.98.0.tar.gz">abi-compliance-checker-1.98.0.tar.gz</a><br /> -<b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>New Features</b> -<ul><li> Implemented XML format of ABI dumps -</li></ul> -</li></ul> -<ul><li> <b>New Options</b> -<ul><li> <a href="Options.html" title="ABI Compliance Checker Options">-dump-format</a> -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Improved support for old ABI dumps -</li><li> Other fixes -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.97.8_.28June_08.2C_2012.29"> Version 1.97.8 (June 08, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.97.8.tar.gz">abi-compliance-checker-1.97.8.tar.gz</a><br /> -<b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release with a few new features. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Redesigned format of ABI dump -</li><li> Optimization of memory usage (5%-10%) and performance (5%-10%) -</li><li> Improved support for GCC 4.0-4.5 -</li><li> Added <add_namespaces> section of the XML descriptor -</li></ul> -</li></ul> -<ul><li> <b>New Options</b> -<ul><li> <a href="Options.html" title="ABI Compliance Checker Options">-open</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-sort</a> -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Improved support for old ABI dumps -</li><li> Fixed a bug with auto-detection of include paths when comparing two XML descriptors -</li><li> Corrected output of <a href="Options.html" title="ABI Compliance Checker Options">-debug</a> option -</li><li> Corrected <a href="Options.html" title="ABI Compliance Checker Options">--dump-system</a> and <a href="Options.html" title="ABI Compliance Checker Options">--cmp-systems</a> options -</li><li> Other fixes -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Code cleaning -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.97.5_.28May_14.2C_2012.29"> Version 1.97.5 (May 14, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.97.5.tar.gz">abi-compliance-checker-1.97.5.tar.gz</a><br /> -<b>ACC 2.0</b> pre-release. -</p><p>This is a bug-fix release. -</p> -<ul><li> <b>Improvements</b> -<ul><li> Extended ABI dumps by source-level type declarations -</li><li> Improved support for old ABI dumps -</li><li> Optimization of memory usage (20%-30%) and performance (10%-20%) -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected auto-detection of a set of target headers to check/dump in --headers-only mode -</li><li> Other fixes -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Extended regression test suite -</li><li> Code cleaning -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.97.4_.28April_16.2C_2012.29"> Version 1.97.4 (April 16, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.97.4.tar.gz">abi-compliance-checker-1.97.4.tar.gz</a><br /> -<b>ACC 2.0</b> pre-release. -</p><p>Improved quality of the compatibility analysis. -</p> -<ul><li> <b>New Features</b> -<ul><li> Added 16 new binary-compatibility rules -</li><li> Added 17 new source-compatibility rules -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Added some missed typedef types to function signatures -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Improved support for old ABI dumps -</li><li> Support for GCC 4.7 -</li><li> Extended regression test suite -</li><li> Code cleaning -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.97.3_.28April_03.2C_2012.29"> Version 1.97.3 (April 03, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/downloads/abi-compliance-checker-1.97.3.tar.gz">abi-compliance-checker-1.97.3.tar.gz</a><br /> -<b>ACC 2.0</b> pre-release. -</p><p>This is a next major release. The tool now checks for both <b>binary</b> and <b>source-level compatibility</b> issues with C/C++ APIs. -</p> -<ul><li> <b>Completed Tasks</b> -<ul><li> Implement source-level compatibility checks (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1371">1371</a>) -</li><li> Implement 2.0 architecture (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1105">1105</a>) -</li></ul> -</li></ul> -<ul><li> <b>New Features</b> -<ul><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--browse=PROG</a> option (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2612">2612</a>) -</li><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--xml</a> alias option for <a href="Options.html" title="ABI Compliance Checker Options">--report-format=xml</a> (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2611">2611</a>) -</li><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--binary</a> option to generate binary-compatibility report only -</li><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--source</a> option to generate source-compatibility report only -</li><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--bin-report-path</a> option: path to binary-compatibility report -</li><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--src-report-path</a> option: path to source-compatibility report -</li></ul> -</li></ul> -<ul><li> <b>Other Features</b> -<ul><li> Improved debug mode (--debug) -</li><li> Improved mark-up of the HTML report -</li><li> Improved support for old ABI dumps -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected ABI dumps -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.96.8_.28February_17.2C_2012.29"> Version 1.96.8 (February 17, 2012) </span></h2> -<p><a rel="nofollow" class="external text" href="http://forge.ispras.ru/attachments/download/1475/abi-compliance-checker-1.96.8.tar.gz">abi-compliance-checker-1.96.8.tar.gz</a><br /> -<b>ACC 2.0</b> pre-release. -</p> -<ul><li> <b>Completed Tasks</b> -<ul><li> Implement XML format for compatibility report (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1984">1984</a>) -</li><li> Testing on MeeGo 1.2 Harmattan Beta2 (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1955">1955</a>) -</li></ul> -</li></ul> -<ul><li> <b>New Features</b> -<ul><li> Add hidden statistics line to compatibility report for operating systems (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2403">2403</a>) -</li><li> Add <a href="Options.html" title="ABI Compliance Checker Options">--headers-list</a> option (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2400">2400</a>) -</li><li> Add <a href="Options.html" title="ABI Compliance Checker Options">--lang</a> option (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2223">2223</a>) -</li><li> Support for symbolic links in /usr/include and /usr/lib (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2022">2022</a>) -</li><li> Add <skip_include_paths> section of XML-descriptor (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2021">2021</a>) -</li><li> Add <skip_including> section of XML-descriptor (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2012">2012</a>) -</li><li> Add <a href="Options.html" title="ABI Compliance Checker Options">--list-affected</a> option to create plain list of incompatible symbols (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1994">1994</a>) -</li><li> Add --quiet option to print all errors and warnings to the log file instead of stderr and stdout (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1983">1983</a>) -</li><li> Add <a href="Options.html" title="ABI Compliance Checker Options">--stdout</a> option to print results to stdout (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1982">1982</a>) -</li><li> Add an option to check binary compatibility in the extended sense (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1855">1855</a>) -</li><li> Improve diagnostic messages for added base classes with virtual functions (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1849">1849</a>) -</li><li> Add -update option to installer (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1837">1837</a>) -</li><li> Add a relative default directory to locate modules after installation (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1836">1836</a>) -</li><li> Compatibility rate = (high+1/2*medium+1/4*low) / number of symbols (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1794">1794</a>) -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Some symbols with extern "C" linkage are missed in --headers-only mode (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2401">2401</a>) -</li><li> Changes in global data are not detected under Windows (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2311">2311</a>) -</li><li> False negative: change global data to be "const" (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2310">2310</a>) -</li><li> Removed middle enumeration value is reported as renamed (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2114">2114</a>) -</li><li> False positive: change parameter type from "const int" to "int" (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2097">2097</a>) -</li><li> Support for old ABI dump format of ACC 1.21.6 (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2024">2024</a>) -</li><li> The tool doesn't search for included headers in /usr/lib/qt4/include/ (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/2010">2010</a>) -</li><li> False Negative: Header is incompatible with itself (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1986">1986</a>) -</li><li> Check libstdc++ in --headers-only mode (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1960">1960</a>) -</li><li> Restrict checked header files in the --headers-only mode (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1944">1944</a>) -</li><li> Problem with mangled C++-functions using old ABI dump formats in --headers-only mode (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1899">1899</a>) -</li><li> Incorrect size of method pointer in ABI dumps (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1897">1897</a>) -</li><li> False negative: add/remove "register" modifier of the parameter (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1882">1882</a>) -</li><li> Incorrect WORD size when using old ABI dump format (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1881">1881</a>) -</li><li> Conflict of a static method with a function of the same name in the ABI dump (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1853">1853</a>) -</li><li> Missed right bracket of "func-ptr" type in HTML report (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1842">1842</a>) -</li><li> Incorrect report for overridden methods (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1824">1824</a>) -</li><li> False negative: override a virtual that doesn't come from a primary base (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1808">1808</a>) -</li><li> False negative: change a function parameter to be "restrict" (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1805">1805</a>) -</li><li> False negative: change a field to be "volatile" (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1803">1803</a>) -</li><li> False negative: change "const"-ness of a return value (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1802">1802</a>) -</li><li> False negative: change "volatile" attribute of a method (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1801">1801</a>) -</li><li> False positive: removed symbols with inline virtual prototype in the leaf class with default constructor (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1791">1791</a>) -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.94_.28September_09.2C_2011.29"> Version 1.94 (September 09, 2011) </span></h2> -<p><a rel="nofollow" class="external text" href="http://upstream-tracker.org/downloads/abi-compliance-checker-1.94.tar.gz">abi-compliance-checker-1.94.tar.gz</a><br /> -<b>ACC 2.0</b> pre-release. -</p> -<ul><li> <b>Completed Tasks</b> -<ul><li> Separated regression tests into the module (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1105">1105</a>) -</li></ul> -</li></ul> -<ul><li> <b>Added Features</b> -<ul><li> Add Makefile.pl installer (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1759">1759</a>) -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.93.8_.28September_08.2C_2011.29"> Version 1.93.8 (September 08, 2011) </span></h2> -<p><a rel="nofollow" class="external text" href="http://upstream-tracker.org/downloads/abi-compliance-checker-1.93.8.tar.gz">abi-compliance-checker-1.93.8.tar.gz</a><br /> -<b>ACC 2.0</b> pre-release. -</p> -<ul><li> <b>Completed Tasks</b> -<ul><li> Separated rules DB (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1105">1105</a>) -</li><li> Testing on Symbian SDK (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1531">1531</a>) -</li><li> Testing on Windows SDK (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1629">1629</a>) -</li><li> Support for OS3000 (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1632">1632</a>) -</li></ul> -</li></ul> -<ul><li> <b>Added Features</b> -<ul><li> SONAME change in the OS comparison table (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1527">1527</a>) -</li><li> Add a compatibility percentage to the OS comparison table (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1595">1595</a>) -</li><li> Add "-debug" option (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1596">1596</a>) -</li><li> Add listing of symbols in OS comparison table (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1597">1597</a>) -</li><li> Use "zip" format of dumps in Windows (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1598">1598</a>) -</li><li> Add "-dump-system descriptor.xml" option (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1602">1602</a>) -</li><li> Analysis of static libraries (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1635">1635</a>) -</li><li> Add -sysinfo option (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1681">1681</a>) -</li><li> Add -component option (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1682">1682</a>) -</li><li> Add -nostdinc option (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1683">1683</a>) -</li><li> Add "weakly"- and "almost"-compatible verdicts (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1178">1178</a>) -</li><li> Add <skip_namespaces> to the library XML-descriptor (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1740">1740</a>) -</li><li> Search for modules/ directory in the system (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1741">1741</a>) -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Missed typedefs in the ABI dump using GCC 4.4.1 (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1526">1526</a>) -</li><li> False negative: change enum member value from zero to non-zero (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1592">1592</a>) -</li><li> False negative: interchange the positions of two fields in a structure (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1593">1593</a>) -</li><li> False positive: add a field instead of padding fields (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1594">1594</a>) -</li><li> Problems with "copied" classes (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1599">1599</a>) -</li><li> Changes in "private" fields (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1600">1600</a>) -</li><li> Illegal modulus zero at abi-compliance-checker.pl (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1651">1651</a>) -</li><li> Incorrect order of include paths (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1653">1653</a>) -</li><li> Change constness of a class method (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1529">1529</a>) -</li><li> False negative: change "struct Type" to "union Type" (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1738">1738</a>) -</li><li> Change parameter type from "..." to "int" (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1750">1750</a>) -</li><li> Remove/add "const"-qualifier of a method (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1751">1751</a>) -</li><li> False negative: renamed parameters (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1753">1753</a>) -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> Improved debug mode (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1596">1596</a>) -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.23.5_.28July_01.2C_2011.29"> Version 1.23.5 (July 01, 2011) </span></h2> -<p><a rel="nofollow" class="external text" href="http://upstream-tracker.org/downloads/abi-compliance-checker-1.23.5.tar.gz">abi-compliance-checker-1.23.5.tar.gz</a><br /> -This is a next bug fix release. Tested on <a rel="nofollow" class="external text" href="http://upstream-tracker.org/">335 libraries</a> -</p> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected exit codes: 0 - compatible, 1 - incompatible, 2 - error, ... (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1351">1351</a>) -</li><li> Corrected diagnostic messages for C++ functions with changed signature (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1361">1361</a>) -</li><li> Fixed regression with C++ non-member functions (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1368">1368</a>) -</li><li> Removed false positive with overridden private methods (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1369">1369</a>) -</li><li> Corrected functionality for checking binary compatibility of operating systems -</li><li> Removed false positive for removed default version of a symbol (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1386">1386</a>) -</li><li> Adapted <a href="Options.html" title="ABI Compliance Checker Options">-dump-system</a> option for MeeGo 1.2 Harmattan (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1400">1400</a>) -</li><li> Fixed hanging execution on "#include "../../file.h" (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1448">1448</a>) -</li><li> Fixed incorrect automatic include paths (<a rel="nofollow" class="external text" href="http://forge.ispras.ru/issues/1458">1458</a>) -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.23_.28June_07.2C_2011.29"> Version 1.23 (June 07, 2011) </span></h2> -<p><a rel="nofollow" class="external text" href="http://upstream-tracker.org/downloads/abi-compliance-checker-1.23.tar.gz">abi-compliance-checker-1.23.tar.gz</a><br /> -This release is sponsored by <a rel="nofollow" class="external text" href="http://www.nokia.com/">Nokia</a>. -</p> -<ul><li> <b>New Features</b> -<ul><li> Added 42 compatibility checks (total: 83) -</li><li> Improved diagnostics of compatibility problems -</li><li> Opened an <a rel="nofollow" class="external text" href="http://forge.ispras.ru/projects/abi-compliance-checker">issue tracker</a> -</li><li> Support for cross-compilers -</li><li> Ported to Mac OS X (10.5) and MS Windows (Xp, Vista, 7) -</li><li> Added a viewer of "real" v-table layouts for changed C++ classes -</li><li> Added functionality to check OS backward compatibility -</li><li> Supports for old-version dump formats (>=1.18) -</li><li> Separated versioning of dump formats -</li><li> Improved design of the compatibility report -</li><li> Improved performance -</li><li> Support for old GCC 3.4.4 -</li></ul> -</li></ul> -<ul><li> <b>New Options</b> -<ul><li> <a href="Options.html" title="ABI Compliance Checker Options">-cross-gcc</a>: support for cross-compilers -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-sysroot</a>: specify the alternative system root directory -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-dump-system</a>, <a href="Options.html" title="ABI Compliance Checker Options">-cmp-systems</a>: checking OS backward compatibility -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-use-dumps</a>: check for compatibility using the intermediate dumping -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-show-retval</a>: show symbol's return value type in the report -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-old-dumps</a>: support for old-version dumps -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-test-dump</a>: test for dumping functionality -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-report-path</a>: change the location of output compatibility report -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-dump-path</a>: change the location of output ABI dump -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-log1-path</a>, <a href="Options.html" title="ABI Compliance Checker Options">-log2-path</a>: change the location of output logs -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Reduced false positives -</li><li> Support for C-headers containing C++ keywords -</li><li> Corrected automatic include paths for headers -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.21.12_.28April_29.2C_2011.29"> Version 1.21.12 (April 29, 2011) </span></h2> -<p><a rel="nofollow" class="external text" href="http://upstream-tracker.org/downloads/abi-compliance-checker-1.21.12.tar.gz">abi-compliance-checker-1.21.12.tar.gz</a> (previous bug-fix releases: <a rel="nofollow" class="external text" href="http://upstream-tracker.org/downloads/abi-compliance-checker-1.21.9.tar.gz">1.21.9</a>, <a rel="nofollow" class="external text" href="http://upstream-tracker.org/downloads/abi-compliance-checker-1.21.6.tar.gz">1.21.6</a>)<br /> -This is a next bug fix release. Tested on <a rel="nofollow" class="external text" href="http://upstream-tracker.org/">280 libraries</a>. -</p> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected automatic detection of include paths for header files. -</li><li> Removed false positives with overridden virtual functions. -</li><li> Corrected processing of typedef type names, fixed potential program hangup. -</li><li> Added some missed problems relating to the return type changes of a function. -</li><li> Corrected processing of a translation unit dump generated by modern GCC versions. -</li><li> Corrected identifying of inline functions (using the -fkeep-inline-functions GCC option). -</li><li> Corrected parser for C++: analysis of const global data and functions inside a namespace. -</li><li> Corrected names and v-table checks for template types. -</li><li> Corrected checks for changes in enumerations. -</li><li> Corrected ABI dumping and sorting of dumps. -</li><li> Corrected analysis of added/removed virtual functions. -</li><li> Corrected help message and documentation. -</li><li> Documentation has been moved to "doc/" subdirectory. -</li><li> Using File::Temp for storing temporary files. -</li><li> Support for latest GCC 4.6.0 and old GCC v3.x series. -</li><li> Fixed infinite loop finding the path for "which" command in the system. -</li><li> Corrected distinction of descriptor kinds (headers, libraries, directories and XML-descriptors). -</li><li> Corrected processing of <include_paths> section in the XML-descriptors. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.21_.28August_19.2C_2010.29"> Version 1.21 (August 19, 2010) </span></h2> -<p><a rel="nofollow" class="external text" href="http://upstream-tracker.org/downloads/abi-compliance-checker-1.21.tar.gz">abi-compliance-checker-1.21.tar.gz</a><br /> -This release includes many improvements and bug fixes. Tested on <a rel="nofollow" class="external text" href="http://upstream-tracker.org/">155 libraries</a>. -</p> -<ul><li> <b>New Features</b> -<ul><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--check-implementation</a> option: compare disassembled binary code to detect changes in the interface implementation. -</li><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--objects-only</a> option: compare shared objects without header files. -</li><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--v1 and --v2</a> options: specify version number outside the descriptor. -</li><li> Improved help message. -</li><li> Improved performance of the tool. -</li><li> Removed template instances and stdc++ interfaces from the report (C++). -</li><li> Added README.html and CHANGES.html to the package. -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected ABI compatibility report. -</li><li> Corrected interface names and versions in the report. -</li><li> Corrected number of problems in report summary. -</li><li> Corrected ABI dump. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.20_.28August_30.2C_2010.29"> Version 1.20 (August 30, 2010) </span></h2> -<p><a rel="nofollow" class="external text" href="http://upstream-tracker.org/downloads/abi-compliance-checker-1.20.tar.gz">abi-compliance-checker-1.20.tar.gz</a><br /> -This is a next bug fix release. Tested on <a rel="nofollow" class="external text" href="http://upstream-tracker.org/">145 libraries</a>. -</p> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected reports about added/withdrawn members in the structure types and added/withdrawn parameters. -</li><li> Corrected report about added/withdrawn virtual functions if -headers_only option specified. -</li><li> Corrected processing of header paths containing special characters. -</li></ul> -</li></ul> -<ul><li> <b>New Features</b> -<ul><li> Added <defines> section to the library descriptor: this section allows to add defines at the headers compiling stage. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.19_.28July_22.2C_2010.29"> Version 1.19 (July 22, 2010) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/e/e0/Abi-compliance-checker-1.19.tar.gz" class="internal" title="Abi-compliance-checker-1.19.tar.gz">Abi-compliance-checker-1.19.tar.gz</a><br /> -This is a next bug fix release with several new features. Tested on <a rel="nofollow" class="external text" href="http://upstream-tracker.org/">130 libraries</a>. -</p> -<ul><li> <b>Bug Fixes</b> -<ul><li> Removed duplicated problems from the report. -</li><li> Corrected names of the template instances. -</li><li> Corrected checking of reference type changes. -</li><li> Corrected titles in the report. -</li><li> Corrected size of some array types. -</li><li> Corrected checking of added/withdrawn members in the structure types with reserved members. -</li><li> Corrected checking of added/withdrawn parameters. -</li></ul> -</li></ul> -<ul><li> <b>New Features</b> -<ul><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--library_full_name</a> option to display full library name in title of the report. -</li><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--relpath</a> option for replacing the {RELPATH} in the descriptor for ABI dumping. -</li><li> Added <skip_libs> section to the library descriptor: this section contains a list of shared objects and/or directories with shared objects that should not be processed. -</li><li> Improved performance on big libraries. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.18_.28June_25.2C_2010.29"> Version 1.18 (June 25, 2010) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/f/f4/Abi-compliance-checker-1.18.tar.gz" class="internal" title="Abi-compliance-checker-1.18.tar.gz">Abi-compliance-checker-1.18.tar.gz</a><br /> -This is generally a bug fix release. Tested on <a rel="nofollow" class="external text" href="http://upstream-tracker.org/">100 libraries</a>. -</p> -<ul><li> <b>New Features</b> -<ul><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--relpath1</a> and <a href="Options.html" title="ABI Compliance Checker Options">--relpath2</a> options for replacing the {RELPATH} in the descriptors. Old option -relpath was removed. -</li><li> Added <add_include_paths> section to the library descriptor: this section contains a list of include paths that should be added to the automatically detected include paths. -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Added some previously missed compatibility problems in the report. -</li><li> Corrected techniques for auto-detection of header file dependencies (include paths). -</li><li> Removed problems relating to the changes in the temporary header files. -</li><li> Corrected interface signatures in the report. -</li><li> Corrected checking of added/withdrawn parameters. -</li><li> Corrected changes in the virtual tables of the libraries with symbol versioning. -</li><li> Corrected checking of complex namespaces changes (C++). -</li><li> Added namespaces information to the ABI dump. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.17.2_.28June_16.2C_2010.29"> Version 1.17.2 (June 16, 2010) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/6/6e/Abi-compliance-checker-1.17.2.tar.gz" class="internal" title="Abi-compliance-checker-1.17.2.tar.gz">Abi-compliance-checker-1.17.2.tar.gz</a><br /> -This intermediate release includes several bug fixes. -</p> -<ul><li> <b>Bug Fixes</b> -<ul><li> Repaired <a href="Options.html" title="ABI Compliance Checker Options">--separately</a> option. -</li><li> Corrected permissions of LICENSE file. -</li><li> Corrected tool description. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.17.1_.28June_09.2C_2010.29"> Version 1.17.1 (June 09, 2010) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/9/99/Abi-compliance-checker-1.17.1.tar.gz" class="internal" title="Abi-compliance-checker-1.17.1.tar.gz">Abi-compliance-checker-1.17.1.tar.gz</a><br /> -This intermediate release includes critical bug fixes. -</p> -<ul><li> <b>New Features</b> -<ul><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--relpath</a> option for adding prefixes to the paths in the library descriptor. -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected checking of added/withdrawn parameters. -</li><li> Corrected processing of mixed C/C++ header sets. -</li><li> Corrected checking of parameter type changes. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.17_.28June_08.2C_2010.29"> Version 1.17 (June 08, 2010) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/e/e7/Abi-compliance-checker-1.17.tar.gz" class="internal" title="Abi-compliance-checker-1.17.tar.gz">Abi-compliance-checker-1.17.tar.gz</a><br /> -This is generally a bug fix release. Tested on <a rel="nofollow" class="external text" href="http://upstream-tracker.org/">75 libraries</a>. -</p> -<ul><li> <b>New Features</b> -<ul><li> Visualizing of the serious changes (added/withdrawn parameters) in the interface signature. -</li><li> Recursive analysis of constant changes. -</li><li> Separated stderr and stdout streams of the tool. -</li><li> Added <skip_constants> section to the library descriptor for skipping checks of some constants. -</li><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--params</a> option for adding function parameter names to the report. -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected analysis of virtual table layout changes. -</li><li> Corrected analysis of parameter type changes. -</li><li> Corrected complex array type names. -</li><li> Corrected typedef names. -</li><li> Corrected analysis of structure layout changes. -</li><li> Fixed tool hanging on some C++ headers (with many namespaces). -</li><li> Corrected analysis of Glibc headers. -</li><li> Corrected analysis of library language changes (if added some C++ headers). -</li><li> Corrected descriptions of some compatibility problems. -</li><li> Corrected analysis of added/withdrawn parameters in C headers. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.16_.28May_05.2C_2010.29"> Version 1.16 (May 05, 2010) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/8/8d/Abi-compliance-checker-1.16.tar.gz" class="internal" title="Abi-compliance-checker-1.16.tar.gz">Abi-compliance-checker-1.16.tar.gz</a><br /> -This release includes many bug fixes and new features after integration to the <b><a rel="nofollow" class="external text" href="http://upstream-tracker.org/">Upstream Tracker</a></b> system.<br /> -</p> -<ul><li> <b>New Features</b> -<ul><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--strict</a> option for treating all compatibility warnings as problems. -</li><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--dumpversion</a> option for printing tool version and don't do anything else. -</li><li> Ignoring hidden .svn, .git, .bzr, .hg, and CVS directories. -</li><li> Improved header files sorting for protecting from compilation errors on the intermediate phase of temporary header file compilation. -</li><li> Improved techniques for auto-detection of header file dependencies (include paths). -</li><li> Ignoring problems related to changes of constants (defines) describing library version (*_VERSION_*, *_COPYRIGHT_* and other). -</li><li> New internal test cases. -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Checking of some previously missed C++ namespaces. -</li><li> Removed hidden "void const** __vtt_parm" parameters from signatures of some constructors. -</li><li> Corrected dumping of C++ classes ABI. -</li><li> Corrected checking of pure virtual destructors. -</li><li> Removed unnecessary built-in constants from the ABI dump. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.15_.28March_26.2C_2010.29"> Version 1.15 (March 26, 2010) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/3/32/Abi-compliance-checker-1.15.tar.gz" class="internal" title="Abi-compliance-checker-1.15.tar.gz">Abi-compliance-checker-1.15.tar.gz</a><br /> -This is generally a bug fix release with the changed license.<br /> -</p> -<ul><li> <b>New Features</b> -<ul><li> The license was changed to dual GNU GPL and LGPL. -</li><li> Added <skip_headers> section in the descriptor. -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected processing of <include_paths> section in the descriptor. -</li><li> Corrected processing of relative paths in the <headers> and <include_paths> sections. -</li><li> Directory with temporary files renamed from "temp" to hidden ".tmp_dir". -</li><li> Corrected processing of shared object dependencies. -</li><li> Corrected processing of some previously missed functions and conversion operators in C++. -</li><li> Corrected internal test suite. -</li><li> Corrected some error messages. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.14_.28March_03.2C_2010.29"> Version 1.14 (March 03, 2010) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/d/de/Abi-compliance-checker-1.14.tar.gz" class="internal" title="Abi-compliance-checker-1.14.tar.gz">Abi-compliance-checker-1.14.tar.gz</a><br /> -</p> -<ul><li> <b>New Features</b> -<ul><li> Added techniques for auto-detection of header file dependencies (include paths). Now providing of <include_paths> section in the descriptor is not necessary. -</li><li> Ported to FreeBSD and Haiku. -</li><li> Added check for gcc/g++ version (>=3.0.0). -</li><li> Added sorting of interface problems by namespace in the report (C++). -</li><li> Improved internal test suite. -</li><li> Added log for describing tool actions and occurred errors. -</li><li> Added exit error code (high/medium risk for ABI break). -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected ABI dumping. -</li><li> Corrected styles in the report design. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.13_.28February_16.2C_2010.29"> Version 1.13 (February 16, 2010) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/b/ba/Abi-compliance-checker-1.13.tar.gz" class="internal" title="Abi-compliance-checker-1.13.tar.gz">Abi-compliance-checker-1.13.tar.gz</a><br /> -This is generally a bug fix release. -</p> -<ul><li> <b>Bug fixes</b> -<ul><li> Corrected processing of tab characters in the descriptor. -</li><li> Corrected help message. -</li><li> Corrected descriptor template structure. -</li><li> Corrected error and warning messages. -</li><li> Corrected processing of shared object dependencies. -</li></ul> -</li></ul> -<ul><li> <b>New features</b> -<ul><li> Added <a href="Options.html" title="ABI Compliance Checker Options">-version</a> option. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.12_.28December_04.2C_2009.29"> Version 1.12 (December 04, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/b/bf/Abi-compliance-checker-1.12.tar.gz" class="internal" title="Abi-compliance-checker-1.12.tar.gz">Abi-compliance-checker-1.12.tar.gz</a><br /> -This is generally a bug fix release. -</p> -<ul><li> <b>Bug fixes</b> -<ul><li> Corrected classification of compatibility problems in the report. -</li><li> Priority of problems related to changes in the methods object was reduced. -</li><li> Corrected complex template type names. -</li></ul> -</li></ul> -<ul><li> <b>New features</b> -<ul><li> New help message. -</li><li> Highlighting of [in-charge], [not-in-charge] constructors and destructors in the report was improved. -</li><li> New option <a href="Options.html" title="ABI Compliance Checker Options">-time</a> for enabling time measurements. -</li><li> New internal test cases. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.11_.28November_10.2C_2009.29"> Version 1.11 (November 10, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/5/59/Abi-compliance-checker-1.11.tar.gz" class="internal" title="Abi-compliance-checker-1.11.tar.gz">Abi-compliance-checker-1.11.tar.gz</a><br /> -</p> -<ul><li> <b>New Features</b> -<ul><li> Added <a href="Options.html" title="ABI Compliance Checker Options">--app</a> option to check portability of applications to the new library version. -</li><li> Memory usage decreased twice. -</li></ul> -</li></ul> -<ul><li> <b>Bug fixes</b> -<ul><li> Corrected checking of added middle structure members. -</li><li> Corrected names of template types (with intrinsic, bool and string parameters). -</li><li> Corrected highlighting of function signatures in the report. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.10_.28November_02.2C_2009.29"> Version 1.10 (November 02, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/3/34/Abi-compliance-checker-1.10.tar.gz" class="internal" title="Abi-compliance-checker-1.10.tar.gz">Abi-compliance-checker-1.10.tar.gz</a><br /> -</p> -<ul><li> <b>New Features</b> -<ul><li> Checking added/dropped function parameters (C language only). -</li><li> Improvements in the design of ABI compliance report. -</li><li> New internal test cases. -</li></ul> -</li></ul> -<ul><li> <b>Bug fixes</b> -<ul><li> Incorrect checking of redefined virtual functions and differences in parameter types. -</li><li> More careful checking of withdrawn interfaces using shared library dependencies. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.9_.28October_12.2C_2009.29"> Version 1.9 (October 12, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/8/8c/Abi-compliance-checker-1.9.tar.gz" class="internal" title="Abi-compliance-checker-1.9.tar.gz">Abi-compliance-checker-1.9.tar.gz</a><br /> -</p> -<ul><li> <b>Improvements</b> -<ul><li> Improved design of ABI compliance report. -</li><li> Improved algorithms of checking parameter/field type change. -</li></ul> -</li></ul> -<ul><li> <b>Bug Fixes</b> -<ul><li> Fixed incorrect names of typedefs and function pointer types. -</li><li> Checking of some previously missed C++-functions. -</li><li> Removed some false positives from the report (for anon-types). -</li></ul> -</li></ul> -<ul><li> <b>Other</b> -<ul><li> New internal test cases. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.8_.28September_29.2C_2009.29"> Version 1.8 (September 29, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/7/75/Abi-compliance-checker-1.8.tar.gz" class="internal" title="Abi-compliance-checker-1.8.tar.gz">Abi-compliance-checker-1.8.tar.gz</a><br /> -It is the bug fix release after integration to the Moblin SigChk and testing Moblin-2.0 libraries for ABI compatibility with Ubuntu-Moblin-Remix-9.10 libraries. -</p> -<ul><li> <b>Bug fixes</b> -<ul><li> Size of ABI info dumps have been reduced through removing of unnecessary information. -</li><li> Incorrect names of template instances and function pointer types. -</li><li> Incorrect positions of function parameters in the section 'Interface Problems' in the report. -</li><li> Removed some false positives from the report. -</li><li> Incorrect handling of special symbols in the paths to header files and shared objects. -</li></ul> -</li></ul> -<ul><li> <b>New features</b> -<ul><li> Added ability to specify a file with a list of interfaces that should be checked. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.7_.28September_11.2C_2009.29"> Version 1.7 (September 11, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/5/5d/Abi-compliance-checker-1.7.tar.gz" class="internal" title="Abi-compliance-checker-1.7.tar.gz">Abi-compliance-checker-1.7.tar.gz</a><br /> -</p> -<ul><li> <b>New features</b> -<ul><li> Checking of incorrect symbols versioning. -</li><li> Checking the values of defines (constants). -</li><li> Ability to check header files without shared objects. It is easy to run, but may provide a low quality ABI compliance report<br />with a lot of false positives and without detecting of added/withdrawn interfaces. -</li><li> Number of checked interfaces and data types in the report. -</li><li> Added tests for checking new features. -</li></ul> -</li></ul> -<ul><li> <b>Bug fixes</b> -<ul><li> Incorrect processing of duplicated headers in the input set (headers with the same name but different paths). -</li><li> Incorrect header files include order. -</li><li> Sorting in the ABI dumps. -</li><li> Incorrect processing of redefined virtual methods. -</li><li> Incorrect processing of anon types. -</li><li> Absence of some necessary information about C++-functions in the ABI dumps. -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.6_.28August_31.2C_2009.29"> Version 1.6 (August 31, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/0/0e/Abi-compliance-checker-1.6.tar.gz" class="internal" title="Abi-compliance-checker-1.6.tar.gz">Abi-compliance-checker-1.6.tar.gz</a><br /> -</p> -<ul><li> <b>Bug Fixes</b> -<ul><li> Corrected processing of relative paths in library descriptors -</li><li> Displaying of machine hardware name instead of processor type in the ABI compliance report -</li><li> Many grammar/spelling errors have been fixed -</li><li> Section "internal_interfaces" in the library descriptor has been renamed to "skip_interfaces" -</li><li> Cosmetic changes in the code -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.5_.28August_25.2C_2009.29"> Version 1.5 (August 25, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/7/79/Abi-compliance-checker-1.5.tar.gz" class="internal" title="Abi-compliance-checker-1.5.tar.gz">Abi-compliance-checker-1.5.tar.gz</a><br /> -</p> -<ul><li> <b>Bug Fixes</b> -<ul><li> Absent information about opaque types and internal interfaces has been added to the ABI dump -</li><li> Some fixes in the design of ABI compliance report -</li><li> Some fixes in grammar/spelling -</li><li> The section "internal_functions" in the library descriptor has been renamed to "internal_interfaces" -</li><li> ABI dump has been renamed to "*.abi.tar.gz" (previously it was "*.info.tar.gz") -</li><li> Corrected interface names in the ABI compliance report (for -separately option) -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.4_.28August_18.2C_2009.29"> Version 1.4 (August 18, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/c/c1/Abi-compliance-checker-1.4.tar.gz" class="internal" title="Abi-compliance-checker-1.4.tar.gz">Abi-compliance-checker-1.4.tar.gz</a><br /> -</p> -<ul><li> <b>Improvements</b> -<ul><li> Added ability to check ABI compliance of library versions placed on different machines -</li><li> Header files checking mode by default has been changed: checking all header files together instead of separate checking -</li></ul> -</li><li> <b>Bug Fixes</b> -<ul><li> Incorrect description for affected interfaces -</li><li> Incorrect virtual table checking -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.3_.28August_14.2C_2009.29"> Version 1.3 (August 14, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/4/47/Abi-compliance-checker-1.3.tar.gz" class="internal" title="Abi-compliance-checker-1.3.tar.gz">Abi-compliance-checker-1.3.tar.gz</a><br /> -This is the bug fix release. -</p> -<ul><li> <b>Bug Fixes</b> -<ul><li> Incorrect number of binary compatibility problems in the report summary -</li><li> Incorrect design of problem descriptions in the report -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.2_.28August_07.2C_2009.29"> Version 1.2 (August 07, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/a/a0/Abi-compliance-checker-1.2.tar.gz" class="internal" title="Abi-compliance-checker-1.2.tar.gz">Abi-compliance-checker-1.2.tar.gz</a><br /> -New email address for bug reports and feature requests. -</p> -<h2> <span class="mw-headline" id="Version_1.1_.28August_06.2C_2009.29"> Version 1.1 (August 06, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/5/58/Abi-compliance-checker-1.1.tar.gz" class="internal" title="Abi-compliance-checker-1.1.tar.gz">Abi-compliance-checker-1.1.tar.gz</a><br /> -</p> -<ul><li> <b>Improvements</b> -<ul><li> Design of the ABI compliance report has been greatly improved -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Version_1.0_.28July_31.2C_2009.29"> Version 1.0 (July 31, 2009) </span></h2> -<p><a href="http://ispras.linuxbase.org/images/b/ba/Abi-compliance-checker-1.0.0.tar.gz" class="internal" title="Abi-compliance-checker-1.0.0.tar.gz">Abi-compliance-checker-1.0.0.tar.gz</a><br /> -Initial prototype of the tool. -</p> -<!-- -NewPP limit report -Preprocessor node count: 191/1000000 -Post-expand include size: 0/2097152 bytes -Template argument size: 0/2097152 bytes -Expensive parser function count: 0/100 ---> - -<!-- Saved in parser cache with key rasispdb:pcache:idhash:2293-0!*!0!!en!*!* and timestamp 20140123092124 --> -</div></div></div></div></div></body></html>
\ No newline at end of file diff --git a/doc/Descriptor.html b/doc/Descriptor.html deleted file mode 100644 index 5aaefe3..0000000 --- a/doc/Descriptor.html +++ /dev/null @@ -1,514 +0,0 @@ - -<!DOCTYPE html> -<html lang="en" dir="ltr" class="client-nojs"> -<head> -<title>Library Descriptor</title> -<meta charset="UTF-8" /> -<meta name="generator" content="MediaWiki 1.18.1" /> -<link rel="shortcut icon" href="/favicon.ico" /> -<link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="ISP_RAS (en)" /> -<link rel="EditURI" type="application/rsd+xml" href="http://ispras.linuxbase.org/api.php?action=rsd" /> -<link rel="alternate" type="application/atom+xml" title="ISP_RAS Atom feed" href="/index.php?title=Special:RecentChanges&feed=atom" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=mediawiki.legacy.commonPrint%2Cshared%7Cskins.monobook&only=styles&skin=monobook&*" /> -<!--[if lt IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE50Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE55Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 6]><link rel="stylesheet" href="/skins/monobook/IE60Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 7]><link rel="stylesheet" href="/skins/monobook/IE70Fixes.css?303" media="screen" /><![endif]--><meta name="ResourceLoaderDynamicStyles" content="" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=site&only=styles&skin=monobook&*" /> -<style>a:lang(ar),a:lang(ckb),a:lang(fa),a:lang(kk-arab),a:lang(mzn),a:lang(ps),a:lang(ur){text-decoration:none}a.new,#quickbar a.new{color:#ba0000} - -/* cache key: rasispdb:resourceloader:filter:minify-css:4:c88e2bcd56513749bec09a7e29cb3ffa */ -</style> -<script src="/load.php?debug=false&lang=en&modules=startup&only=scripts&skin=monobook&*"></script> -<script>if(window.mw){ - mw.config.set({"wgCanonicalNamespace": "", "wgCanonicalSpecialPageName": false, "wgNamespaceNumber": 0, "wgPageName": "Library_Descriptor", "wgTitle": "Library Descriptor", "wgCurRevisionId": 8241, "wgArticleId": 2415, "wgIsArticle": true, "wgAction": "view", "wgUserName": null, "wgUserGroups": ["*"], "wgCategories": ["API Sanity Checker", "ABI Compliance Checker"], "wgBreakFrames": false, "wgRestrictionEdit": [], "wgRestrictionMove": []}); -} -</script><script>if(window.mw){ - mw.loader.load(["mediawiki.page.startup"]); -} -</script> -</head> -<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-Library_Descriptor action-view skin-monobook"> -<div id="globalWrapper"> -<div id="column-content"><div id="content"> - <a id="top"></a> - - <h1 id="firstHeading" class="firstHeading">Library Descriptor</h1> - <div id="bodyContent"> - <div id="siteSub"></div> - <div id="contentSub"></div> - - <!-- start content --> -<div lang="en" dir="ltr" class="mw-content-ltr"><p><i>Library descriptor</i> is a simple XML-file that specifies version number, paths to header files and shared libraries and optionally some other information. -</p> -<table id="toc" class="toc"><tr><td><div id="toctitle"><h2>Contents</h2></div> -<ul> -<li class="toclevel-1 tocsection-1"><a href="#Primary_Sections"><span class="tocnumber">1</span> <span class="toctext">Primary Sections</span></a></li> -<li class="toclevel-1 tocsection-2"><a href="#Optional_Sections"><span class="tocnumber">2</span> <span class="toctext">Optional Sections</span></a></li> -<li class="toclevel-1 tocsection-3"><a href="#Extra_Sections_.28API_Sanity_Checker.29"><span class="tocnumber">3</span> <span class="toctext">Extra Sections (API Sanity Checker)</span></a></li> -<li class="toclevel-1 tocsection-4"><a href="#Examples"><span class="tocnumber">4</span> <span class="toctext">Examples</span></a></li> -</ul> -</td></tr></table> -<h2> <span class="mw-headline" id="Primary_Sections"> Primary Sections </span></h2> -<pre> <span style="color:Green;"><version></span> - /* Version of the library */ - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /* The list of paths to header files or/and - directories with header files, one per line */ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /* The list of paths to shared libraries or/and - directories with shared libraries, one per line */ - <span style="color:Green;"></libs></span> -</pre> -<h2> <span class="mw-headline" id="Optional_Sections"> Optional Sections </span></h2> -<pre> <span style="color:Green;"><include_paths></span> - /* The list of paths to be searched for header files - needed for compiling of library headers, one per line. - NOTE: If you define this section then the tool - will not automatically detect include paths */ - <span style="color:Green;"></include_paths></span> - - <span style="color:Green;"><add_include_paths></span> - /* The list of include paths that should be added - to the automatically detected include paths, one per line */ - <span style="color:Green;"></add_include_paths></span> - - <span style="color:Green;"><skip_include_paths></span> - /* The list of include paths that will be removed from the - list of automatically generated include paths, one per line */ - <span style="color:Green;"></skip_include_paths></span> - - <span style="color:Green;"><gcc_options></span> - /* Additional GCC options, one per line */ - <span style="color:Green;"></gcc_options></span> - - <span style="color:Green;"><include_preamble></span> - /* The list of header files that should be included before other headers, one per line. - For example, it is a tree.h for libxml2 and ft2build.h for freetype2 library */ - <span style="color:Green;"></include_preamble></span> - - <span style="color:Green;"><defines></span> - /* Add defines at the headers compiling stage, one per line: - #define A B - #define C D */ - <span style="color:Green;"></defines></span> - - <span style="color:Green;"><add_namespaces></span> - /* The list of namespaces that should be added to the alanysis - if the tool cannot find them automatically, one per line */ - <span style="color:Green;"></add_namespaces></span> - - <span style="color:Green;"><skip_types></span> - /* The list of data types, that - should not be checked, one per line */ - <span style="color:Green;"></skip_types></span> - - <span style="color:Green;"><skip_symbols></span> - /* The list of functions (mangled/symbol names in C++), - that should not be checked, one per line */ - <span style="color:Green;"></skip_symbols></span> - - <span style="color:Green;"><skip_namespaces></span> - /* The list of C++ namespaces, that - should not be checked, one per line */ - <span style="color:Green;"></skip_namespaces></span> - - <span style="color:Green;"><skip_constants></span> - /* The list of constants that should not be checked, one name per line */ - <span style="color:Green;"></skip_constants></span> - - <span style="color:Green;"><skip_headers></span> - /* The list of header files and/or directories - with header files that should not be checked, one per line */ - <span style="color:Green;"></skip_headers></span> - - <span style="color:Green;"><skip_libs></span> - /* The list of shared libraries and/or directories - with shared libraries that should not be checked, one per line */ - <span style="color:Green;"></skip_libs></span> - - <span style="color:Green;"><skip_including></span> - /* The list of header files, that cannot be included - directly (or non-self compiled ones), one per line */ - <span style="color:Green;"></skip_including></span> - - <span style="color:Green;"><search_headers></span> - /* List of directories to be searched - for header files to automatically - generate include paths, one per line */ - <span style="color:Green;"></search_headers></span> - - <span style="color:Green;"><search_libs></span> - /* List of directories to be searched - for shared librariess to resolve - dependencies, one per line */ - <span style="color:Green;"></search_libs></span> - - <span style="color:Green;"><tools></span> - /* List of directories with tools used - for analysis (GCC toolchain), one per line */ - <span style="color:Green;"></tools></span> - - <span style="color:Green;"><cross_prefix></span> - /* GCC toolchain prefix. - Examples: - arm-linux-gnueabi - arm-none-symbianelf */ - <span style="color:Green;"></cross_prefix></span> -</pre> -<h2> <span class="mw-headline" id="Extra_Sections_.28API_Sanity_Checker.29"> Extra Sections (API Sanity Checker) </span></h2> -<pre> <span style="color:Green;"><test_include_preamble></span> - /* The list of header files that should be - included in each test case before other - headers, one per line */ - <span style="color:Green;"></test_include_preamble></span> - - <span style="color:Green;"><test_defines></span> - /* Add defines to test cases */ - <span style="color:Green;"></test_defines></span> -</pre> -<h2> <span class="mw-headline" id="Examples"> Examples </span></h2> -<ul><li> <b>libssh</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 0.3.4 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/libssh/0.3.4/include/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/libssh/0.3.4/lib/ - <span style="color:Green;"></libs></span> -</pre> -<ul><li> <b>ATK</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 1.28.0 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/atk-1.28.0/include/atk-1.0/atk/atk.h - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/atk-1.28.0/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_paths></span> - /usr/include/glib-2.0/ - /usr/lib/glib-2.0/include/ - <span style="color:Green;"></include_paths></span> -</pre> -<ul><li> <b>libxml2</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 2.7.6 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/libxml2-2.7.6/include/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/libxml2-2.7.6/lib/libxml2.so.2.7.6 - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_preamble></span> - tree.h - <span style="color:Green;"></include_preamble></span> -</pre> -<ul><li> <b>libX11</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 1.3.2 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/libX11-1.3.2/include/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/libX11-1.3.2/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_preamble></span> - Xlib.h - <span style="color:Green;"></include_preamble></span> -</pre> -<ul><li> <b>BlackBerry 10 Native SDK</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 10 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /home/RIM/bbndk/target_10_0_9_1673/qnx6/usr/include/bb/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><search_headers></span> - /home/RIM/bbndk/target_10_0_9_1673/qnx6/usr/include/ - <span style="color:Green;"></search_headers></span> - - <span style="color:Green;"><libs></span> - /home/RIM/bbndk/target_10_0_9_1673/qnx6/x86/usr/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><tools></span> - /home/RIM/bbndk/host_10_0_9_404/linux/x86/usr/bin/ - <span style="color:Green;"></tools></span> - - <span style="color:Green;"><cross_prefix></span> - i486-pc-nto-qnx8.0.0 - <span style="color:Green;"></cross_prefix></span> -</pre> -<ul><li> <b>libQtCore</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 4.6.0 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/Qt-4.6.0/include/QtCore/QtCore - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/Qt-4.6.0/lib/libQtCore.so.4 - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_paths></span> - /usr/local/Qt-4.6.0/include/ - <span style="color:Green;"></include_paths></span> - - <span style="color:Green;"><gcc_options></span> - -fvisibility=hidden - -fvisibility-inlines-hidden - -fPIC - -Wall - -W - -D_REENTRANT - -DQT_NO_CAST_FROM_ASCII - -DQT_NO_CAST_TO_ASCII - -DQT_NO_STL - -DQT_SHARED - -DQT3_SUPPORT - <span style="color:Green;"></gcc_options></span> -</pre> -<ul><li> <b>libxslt</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 1.1.22 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/libxslt-1.1.22/include/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/libxslt-1.1.22/lib/libxslt.so - /usr/local/libxslt-1.1.22/lib/libexslt.so - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_paths></span> - /usr/include/libxml2/ - <span style="color:Green;"></include_paths></span> - - <span style="color:Green;"><include_preamble></span> - xsltInternals.h - <span style="color:Green;"></include_preamble></span> -</pre> -<ul><li> <b>libxml++</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 2.26.1 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/libxml++-2.26.1/include/ - /usr/local/libxml++-2.26.1/lib/libxml++-2.6/include/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/libxml++-2.26.1/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_paths></span> - /usr/include/glib-2.0/ - /usr/lib/glib-2.0/include/ - /usr/include/glibmm-2.4/ - /usr/lib/glibmm-2.4/include/ - <span style="color:Green;"></include_paths></span> -</pre> -<ul><li> <b>pango</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 1.26.0 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/pango-1.26.0/include/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/pango-1.26.0/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_paths></span> - /usr/include/glib-2.0/ - /usr/lib/glib-2.0/include/ - /usr/include/cairo/ - /usr/include/freetype2/ - /usr/include/X11/ - <span style="color:Green;"></include_paths></span> - - <span style="color:Green;"><include_preamble></span> - pango.h - <span style="color:Green;"></include_preamble></span> -</pre> -<ul><li> <b>gtk+</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 2.18.4 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/gtk+-2.18.4/include/gtk-2.0/gdk/gdk.h - /usr/local/gtk+-2.18.4/include/gtk-2.0/gtk/gtk.h - /usr/local/gtk+-2.18.4/include/gail-1.0/ - /usr/local/gtk+-2.18.4/include/gtk-unix-print-2.0/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/gtk+-2.18.4/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_paths></span> - /usr/include/atk-1.0/ - /usr/include/glib-2.0/ - /usr/lib/glib-2.0/include/ - /usr/include/cairo/ - /usr/include/pango-1.0/ - <span style="color:Green;"></include_paths></span> -</pre> -<ul><li> <b>glib</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 2.22.2 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/glib-2.22.2/include/glib-2.0/glib.h - /usr/local/glib-2.22.2/include/glib-2.0/glib-object.h - /usr/local/glib-2.22.2/include/glib-2.0/gmodule.h - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/glib-2.22.2/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_paths></span> - /usr/local/glib-2.22.2/lib/glib-2.0/include/ - <span style="color:Green;"></include_paths></span> -</pre> -<ul><li> <b>libsoup</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 2.28.0 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/libsoup-2.28.0/include/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/libsoup-2.28.0/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_paths></span> - /usr/include/glib-2.0/ - /usr/lib/glib-2.0/include/ - <span style="color:Green;"></include_paths></span> -</pre> -<ul><li> <b>allegro</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 4.9.9.1 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/include/allegro5/allegro.h - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/lib/liballegro-4.9.9.so - <span style="color:Green;"></libs></span> -</pre> -<ul><li> <b>mathgl</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 1.9.0.1 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/mathgl-1.9.0.1/include/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/mathgl-1.9.0.1/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_paths></span> - /usr/local/gsl-1.9/include/ - <span style="color:Green;"></include_paths></span> -</pre> -<ul><li> <b>gsl</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 1.9 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/gsl-1.9/include/ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/gsl-1.9/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_preamble></span> - stdlib.h - <span style="color:Green;"></include_preamble></span> -</pre> -<ul><li> <b>libjpeg</b> -</li></ul> -<pre> <span style="color:Green;"><version></span> - 7 - <span style="color:Green;"></version></span> - - <span style="color:Green;"><headers></span> - /usr/local/libjpeg-7/include/jpeglib.h - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /usr/local/libjpeg-7/lib/ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><include_preamble></span> - stdio.h - <span style="color:Green;"></include_preamble></span> -</pre> -<!-- -NewPP limit report -Preprocessor node count: 195/1000000 -Post-expand include size: 0/2097152 bytes -Template argument size: 0/2097152 bytes -Expensive parser function count: 0/100 ---> - -<!-- Saved in parser cache with key rasispdb:pcache:idhash:2415-0!*!*!!en!*!* and timestamp 20140122135111 --> -</div></div></div></div></div></body></html>
\ No newline at end of file diff --git a/doc/Options.html b/doc/Options.html deleted file mode 100644 index e298381..0000000 --- a/doc/Options.html +++ /dev/null @@ -1,293 +0,0 @@ - -<!DOCTYPE html> -<html lang="en" dir="ltr" class="client-nojs"> -<head> -<title>ABI Compliance Checker Options</title> -<meta charset="UTF-8" /> -<meta name="generator" content="MediaWiki 1.18.1" /> -<link rel="shortcut icon" href="/favicon.ico" /> -<link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="ISP_RAS (en)" /> -<link rel="EditURI" type="application/rsd+xml" href="http://ispras.linuxbase.org/api.php?action=rsd" /> -<link rel="alternate" type="application/atom+xml" title="ISP_RAS Atom feed" href="/index.php?title=Special:RecentChanges&feed=atom" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=mediawiki.legacy.commonPrint%2Cshared%7Cskins.monobook&only=styles&skin=monobook&*" /> -<!--[if lt IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE50Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE55Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 6]><link rel="stylesheet" href="/skins/monobook/IE60Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 7]><link rel="stylesheet" href="/skins/monobook/IE70Fixes.css?303" media="screen" /><![endif]--><meta name="ResourceLoaderDynamicStyles" content="" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=site&only=styles&skin=monobook&*" /> -<style>a:lang(ar),a:lang(ckb),a:lang(fa),a:lang(kk-arab),a:lang(mzn),a:lang(ps),a:lang(ur){text-decoration:none}a.new,#quickbar a.new{color:#ba0000} - -/* cache key: rasispdb:resourceloader:filter:minify-css:4:c88e2bcd56513749bec09a7e29cb3ffa */ -</style> -<script src="/load.php?debug=false&lang=en&modules=startup&only=scripts&skin=monobook&*"></script> -<script>if(window.mw){ - mw.config.set({"wgCanonicalNamespace": "", "wgCanonicalSpecialPageName": false, "wgNamespaceNumber": 0, "wgPageName": "ABI_compliance_checker_Options", "wgTitle": "ABI Compliance Checker Options", "wgCurRevisionId": 8347, "wgArticleId": 2442, "wgIsArticle": true, "wgAction": "view", "wgUserName": null, "wgUserGroups": ["*"], "wgCategories": ["ABI Compliance Checker"], "wgBreakFrames": false, "wgRestrictionEdit": [], "wgRestrictionMove": []}); -} -</script><script>if(window.mw){ - mw.loader.load(["mediawiki.page.startup"]); -} -</script> -</head> -<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-ABI_compliance_checker_Options action-view skin-monobook"> -<div id="globalWrapper"> -<div id="column-content"><div id="content"> - <a id="top"></a> - - <h1 id="firstHeading" class="firstHeading">ABI Compliance Checker Options</h1> - <div id="bodyContent"> - <div id="siteSub"></div> - <div id="contentSub"></div> - - <!-- start content --> -<div lang="en" dir="ltr" class="mw-content-ltr"><table id="toc" class="toc"><tr><td><div id="toctitle"><h2>Contents</h2></div> -<ul> -<li class="toclevel-1 tocsection-1"><a href="#Information_Options"><span class="tocnumber">1</span> <span class="toctext">Information Options</span></a></li> -<li class="toclevel-1 tocsection-2"><a href="#General_Options"><span class="tocnumber">2</span> <span class="toctext">General Options</span></a></li> -<li class="toclevel-1 tocsection-3"><a href="#Extra_Options"><span class="tocnumber">3</span> <span class="toctext">Extra Options</span></a></li> -<li class="toclevel-1 tocsection-4"><a href="#Other_Options"><span class="tocnumber">4</span> <span class="toctext">Other Options</span></a></li> -</ul> -</td></tr></table> -<h2> <span class="mw-headline" id="Information_Options"> Information Options </span></h2> -<ul><li><b>-h|-help</b> -</li></ul> -<div style="padding-left:40px;">Print help message.</div><br /> -<ul><li><b>-i|-info</b> -</li></ul> -<div style="padding-left:40px;">Print complete info.</div><br /> -<ul><li><b>-v|-version</b> -</li></ul> -<div style="padding-left:40px;">Print version information.</div><br /> -<ul><li><b>-dumpversion</b> -</li></ul> -<div style="padding-left:40px;">Print the tool version and don't do anything else.</div><br /> -<h2> <span class="mw-headline" id="General_Options"> General Options </span></h2> -<ul><li><b>-l|-lib|-library NAME</b> -</li></ul> -<div style="padding-left:40px;">Library name (without version). It affects only on the path and the title of the report.</div><br /> -<ul><li><b>-d1|-old|-o PATH</b> -</li></ul> -<div style="padding-left:40px;">Path to the <a href="Descriptor.html" title="Library Descriptor">descriptor</a> of 1st (old) library version.</div><br /> -<ul><li><b>-d2|-new|-n PATH</b> -</li></ul> -<div style="padding-left:40px;">Path to the <a href="Descriptor.html" title="Library Descriptor">descriptor</a> of 2nd (new) library version.</div><br /> -<ul><li><b>-dump|-dump-abi PATH</b> -</li></ul> -<div style="padding-left:40px;">Create library ABI dump for the input XML descriptor. You can transfer it anywhere and pass instead of the descriptor. Also it can be used for debugging the tool.</div><br /> -<ul><li><b>-old-dumps</b> -</li></ul> -<div style="padding-left:40px;">Enable support for old-version ABI dumps.</div><br /> -<h2> <span class="mw-headline" id="Extra_Options"> Extra Options </span></h2> -<ul><li><b>-d|-descriptor-template</b> -</li></ul> -<div style="padding-left:40px;">Create XML-descriptor template ./VERSION.xml</div><br /> -<ul><li><b>-app|-application PATH</b> -</li></ul> -<div style="padding-left:40px;">This option allow to specify the application that should be tested for portability to the new library version.</div><br /> -<ul><li><b>-static-libs</b> -</li></ul> -<div style="padding-left:40px;">Check static libraries instead of the shared ones. The <libs> section of the XML-descriptor should point to static libraries location.</div><br /> -<ul><li><b>-cross-gcc|-gcc-path PATH</b> -</li></ul> -<div style="padding-left:40px;">Path to the cross GCC compiler to use instead of the usual (host) GCC.</div><br /> -<ul><li><b>-cross-prefix|-gcc-prefix PREFIX</b> -</li></ul> -<div style="padding-left:40px;">GCC toolchain prefix.</div><br /> -<ul><li><b>-sysroot DIR</b> -</li></ul> -<div style="padding-left:40px;">Specify the alternative root directory. The tool will search for include paths in the DIR/usr/include and DIR/usr/lib directories.</div><br /> -<ul><li><b>-v1|-version1 NUM</b> -</li></ul> -<div style="padding-left:40px;">Specify 1st library version outside the descriptor.</div><br /> -<ul><li><b>-v2|-version2 NUM</b> -</li></ul> -<div style="padding-left:40px;">Specify 2nd library version outside the descriptor.</div><br /> -<ul><li><b>-s|-strict</b> -</li></ul> -<div style="padding-left:40px;">Treat all compatibility warnings as problems.</div><br /> -<ul><li><b>-headers-only</b> -</li></ul> -<div style="padding-left:40px;">Check header files without shared libraries. It is easy to run, but may provide provide a low quality compatibility report with false positives and without detecting of added/removed symbols.</div><br /> -<ul><li><b>-objects-only</b> -</li></ul> -<div style="padding-left:40px;">Check shared libraries without header files. It is easy to run, but may a low quality report with false positives and without analysis of changes in parameters and data types.</div><br /> -<ul><li><b>-check-impl|-check-implementation</b> -</li></ul> -<div style="padding-left:40px;">Compare canonified disassembled binary code of shared objects to detect changes in the implementation. Create section 'Changes in Implementation' in the report.</div><br /> -<ul><li><b>-show-retval</b> -</li></ul> -<div style="padding-left:40px;">Show the symbol's return type in the report.</div><br /> -<ul><li><b>-symbols-list PATH</b> -</li></ul> -<div style="padding-left:40px;">This option allow to specify a file with a list of interfaces (mangled names in C++) that should be checked, other library interfaces will not be checked.</div><br /> -<ul><li><b>-skip-symbols PATH</b> -</li></ul> -<div style="padding-left:40px;">The list of symbols that should NOT be checked.</div><br /> -<ul><li><b>-headers-list PATH</b> -</li></ul> -<div style="padding-left:40px;">The file with a list of headers, that should be checked/dumped.</div><br /> -<ul><li><b>-skip-headers PATH</b> -</li></ul> -<div style="padding-left:40px;">The file with the list of header files, that should not be checked.</div><br /> -<ul><li><b>-header NAME</b> -</li></ul> -<div style="padding-left:40px;">Check/Dump ABI of this header only.</div><br /> -<ul><li><b>-use-dumps</b> -</li></ul> -<div style="padding-left:40px;">Make dumps for two versions of a library and compare dumps. This should increase the performance of the tool and decrease the operative memory usage.</div><br /> -<ul><li><b>-nostdinc</b> -</li></ul> -<div style="padding-left:40px;">Do not search the GCC standard system directories for header files.</div><br /> -<ul><li><b>-dump-system NAME -sysroot DIR</b> -</li></ul> -<div style="padding-left:40px;">Find all the shared libraries and header files in DIR directory, create XML descriptors and make ABI dumps for each library. The result set of ABI dumps can be compared (-cmp-systems) with the other one created for other version of operating system in order to check them for compatibility. Do not forget to specify -cross-gcc option if your target system requires some specific version of GCC compiler (different from the host GCC). The system ABI dump will be generated to: sys_dumps/NAME/ARCH.</div><br /> -<ul><li><b>-dump-system PATH</b> -</li></ul> -<div style="padding-left:40px;">The same as the previous option but takes an <a href="Descriptor.html" title="Operating System Descriptor">XML descriptor</a> of the target system.</div><br /> -<ul><li><b>-sysinfo DIR</b> -</li></ul> -<div style="padding-left:40px;">This option may be used with -dump-system to dump ABI of operating systems and configure the dumping process. Default: modules/SysInfo/<target> {unix, symbian, windows}</div><br /> -<ul><li><b>-cmp-systems</b> -</li></ul> -<div style="padding-left:40px;">Compare two system ABI dumps. Create compatibility reports for each library and the common HTML report including the summary of test results for all checked libraries. Report will be generated to: sys_compat_reports/NAME1_to_NAME2/ARCH.</div><br /> -<ul><li><b>-libs-list PATH</b> -</li></ul> -<div style="padding-left:40px;">The file with a list of libraries, that should be dumped by the -dump-system option or should be checked by the -cmp-systems option.</div><br /> -<ul><li><b>-ext|-extended</b> -</li></ul> -<div style="padding-left:40px;">If your library A is supposed to be used by other library B and you want to control the ABI of B, then you should enable this option. The tool will check for changes in all data types, even if they are not used by any function in the library A. Such data types are not part of the A library ABI, but may be a part of the ABI of the B library.</div><br /> -<ul><li><b>-q|-quiet</b> -</li></ul> -<div style="padding-left:40px;">Print all messages to the file instead of stdout and stderr.</div><br /> -<ul><li><b>-stdout</b> -</li></ul> -<div style="padding-left:40px;">Print analysis results (compatibility reports and ABI dumps) to stdout instead of creating a file. This would allow piping data to other programs.</div><br /> -<ul><li><b>-report-format FORMAT</b> -</li></ul> -<div style="padding-left:40px;">Change format of compatibility report: html (default) or xml.</div><br /> -<ul><li><b>-dump-format FORMAT</b> -</li></ul> -<div style="padding-left:40px;">Change format of ABI dump: perl (default) or xml.</div><br /> -<ul><li><b>-xml</b> -</li></ul> -<div style="padding-left:40px;">Alias for: --report-format=xml or --dump-format=xml</div><br /> -<ul><li><b>-lang LANG</b> -</li></ul> -<div style="padding-left:40px;">Set library language (C or C++). You can use this option if the tool cannot auto-detect a language. This option may be useful for checking C-library headers (--lang=C) in -headers-only or -extended modes.</div><br /> -<ul><li><b>-binary|-bin|-abi</b> -</li></ul> -<div style="padding-left:40px;">Show binary-compatibility problems only. Generate report to: compat_reports/LIB_NAME/V1_to_V2/abi_compat_report.html</div><br /> -<ul><li><b>-source|-src|-api</b> -</li></ul> -<div style="padding-left:40px;">Show source-compatibility problems only. Generate report to: compat_reports/LIB_NAME/V1_to_V2/src_compat_report.html</div><br /> -<ul><li><b>-affected-limit LIMIT</b> -</li></ul> -<div style="padding-left:40px;">The maximum number of affected symbols listed under the description of the changed type in the report.</div><br /> -<h2> <span class="mw-headline" id="Other_Options"> Other Options </span></h2> -<ul><li><b>-test</b> -</li></ul> -<div style="padding-left:40px;">Run internal tests. Create two binary incompatible versions of a sample library and run the tool to check them for compatibility. This option allows to check if the tool works correctly in the current environment.</div><br /> -<ul><li><b>-test-dump</b> -</li></ul> -<div style="padding-left:40px;">Test ability to create, restore and compare ABI dumps.</div><br /> -<ul><li><b>-debug</b> -</li></ul> -<div style="padding-left:40px;">Debugging mode. Print debug info on the screen. Save intermediate analysis stages in the debug directory: debug/LIB_NAME/VER/.</div><br /> -<ul><li><b>-cpp-compatible</b> -</li></ul> -<div style="padding-left:40px;">If your header file is written in C language and can be compiled by the C++ compiler (i.e. doesn't contain C++-keywords), then you can tell ACC about this and speedup the analysis.</div><br /> -<ul><li><b>-cpp-incompatible</b> -</li></ul> -<div style="padding-left:40px;">Set this option if input C header files use C++ keywords.</div><br /> -<ul><li><b>-p|-params PATH</b> -</li></ul> -<div style="padding-left:40px;">Path to file with the function parameter names. It can be used for improving report view if the library header files don't contain parameter names. File format:</div><br /> -<div style="padding-left:70px;">func1;param1;param2;param3 ...<br /> -<p>func2;param1;param2;param3 ...<br /> -</p> -  ...</div><br /> -<ul><li><b>-relpath PATH</b> -</li></ul> -<div style="padding-left:40px;">Replace {RELPATH} macros to PATH in the XML-descriptor used for dumping the library ABI (see -dump option).</div><br /> -<ul><li><b>-relpath1 PATH</b> -</li></ul> -<div style="padding-left:40px;">Replace {RELPATH} macros to PATH in the 1st XML-descriptor (see -d1 option).</div><br /> -<ul><li><b>-relpath2 PATH</b> -</li></ul> -<div style="padding-left:40px;">Replace {RELPATH} macros to PATH in the 2nd XML-descriptor (see -d2 option).</div><br /> -<ul><li><b>-dump-path PATH</b> -</li></ul> -<div style="padding-left:40px;">Specify a *.abi.tar.gz or *.abi file path where to generate an ABI dump. Default path: abi_dumps/LIB_NAME/LIB_NAME_VERSION.abi.tar.gz</div><br /> -<ul><li><b>-sort</b> -</li></ul> -<div style="padding-left:40px;">Enable sorting of data in ABI dumps.</div><br /> -<ul><li><b>-report-path PATH</b> -</li></ul> -<div style="padding-left:40px;">Specify the file path where to generate the compatibility report. Default report path: compat_reports/LIB_NAME/V1_to_V2/abi_compat_report.html</div><br /> -<ul><li><b>-bin-report-path PATH</b> -</li></ul> -<div style="padding-left:40px;">Path to binary-compatibility report. Default: compat_reports/LIB_NAME/V1_to_V2/abi_compat_report.html</div><br /> -<ul><li><b>-src-report-path PATH</b> -</li></ul> -<div style="padding-left:40px;">Path to source-compatibility report. Default: compat_reports/LIB_NAME/V1_to_V2/src_compat_report.html</div><br /> -<ul><li><b>-log-path PATH</b> -</li></ul> -<div style="padding-left:40px;">Log path for all messages. Default log path: logs/LIB_NAME/VER/log.txt</div><br /> -<ul><li><b>-log1-path PATH</b> -</li></ul> -<div style="padding-left:40px;">Log path for 1st version of a library. Default log path: logs/LIB_NAME/V1/log.txt</div><br /> -<ul><li><b>-log2-path PATH</b> -</li></ul> -<div style="padding-left:40px;">Log path for 2nd version of a library. Default log path: logs/LIB_NAME/V1/log.txt</div><br /> -<ul><li><b>-logging-mode MODE</b> -</li></ul> -<div style="padding-left:40px;">Change logging mode. Modes: w - overwrite old logs (default), a - append old logs, n - do not write any logs</div><br /> -<ul><li><b>-list-affected</b> -</li></ul> -<div style="padding-left:40px;">Generate file with the list of incompatible symbols beside the HTML compatibility report. Use 'c++filt @file' command from GNU Binutils to unmangle C++ symbols in the generated file. Default name: abi_affected.txt</div><br /> -<ul><li><b>-component NAME</b> -</li></ul> -<div style="padding-left:40px;">The component name in the title and summary of the HTML report. Default: library</div><br /> -<ul><li><b>-l-full|-lib-full NAME</b> -</li></ul> -<div style="padding-left:40px;">Change library name in the report title to NAME. By default will be displayed a name specified by -l option.</div><br /> -<ul><li><b>-b|-browse PROGRAM</b> -</li></ul> -<div style="padding-left:40px;">Open report(s) in the browser (firefox, opera, etc.).</div><br /> -<ul><li><b>-open</b> -</li></ul> -<div style="padding-left:40px;">Open report(s) in the default browser.</div><br /> -<ul><li><b>-extra-info DIR</b> -</li></ul> -<div style="padding-left:40px;">Dump extra info to DIR.</div><br /> -<ul><li><b>-extra-dump</b> -</li></ul> -<div style="padding-left:40px;">Create extended ABI dump containing all symbols from the translation unit.</div><br /> -<ul><li><b>-force</b> -</li></ul> -<div style="padding-left:40px;">Try to use this option if the tool doesn't work.</div><br /> -<ul><li><b>-tolerance LEVEL</b> -</li></ul> -<div style="padding-left:40px;">Apply a set of heuristics to successfully compile input header files. You can enable several tolerance levels by joining them into one string (e.g. 13, 124, etc.). Levels: 1 - skip non-Linux headers (e.g. win32_*.h, etc.), 2 - skip internal headers (e.g. *_p.h, impl/*.h, etc.), 3 - skip headers that iclude non-Linux headers, 4 - skip headers included by others.</div><br /> -<ul><li><b>-tolerant</b> -</li></ul> -<div style="padding-left:40px;">Enable highest tolerance level [1234].</div><br /> -<ul><li><b>-check</b> -</li></ul> -<div style="padding-left:40px;">Check completeness of the ABI dump.</div><br /> -<ul><li><b>-quick</b> -</li></ul> -<div style="padding-left:40px;">Quick analysis. Disable check of some template instances.</div><br /> -<ul><li><b>-skip-internal PATTERN</b> -</li></ul> -<div style="padding-left:40px;">Do not check internal interfaces matched by the pattern.</div><br /> - -<!-- -NewPP limit report -Preprocessor node count: 90/1000000 -Post-expand include size: 0/2097152 bytes -Template argument size: 0/2097152 bytes -Expensive parser function count: 0/100 ---> - -<!-- Saved in parser cache with key rasispdb:pcache:idhash:2442-0!*!0!!en!*!* and timestamp 20140123092500 --> -</div></div></div></div></div></body></html>
\ No newline at end of file diff --git a/doc/Readme.html b/doc/Readme.html deleted file mode 100644 index 0ecbaa3..0000000 --- a/doc/Readme.html +++ /dev/null @@ -1,503 +0,0 @@ - -<!DOCTYPE html> -<html lang="en" dir="ltr" class="client-nojs"> -<head> -<title>ABI Compliance Checker</title> -<meta charset="UTF-8" /> -<meta name="generator" content="MediaWiki 1.18.1" /> -<link rel="shortcut icon" href="/favicon.ico" /> -<link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="ISP_RAS (en)" /> -<link rel="EditURI" type="application/rsd+xml" href="http://ispras.linuxbase.org/api.php?action=rsd" /> -<link rel="alternate" type="application/atom+xml" title="ISP_RAS Atom feed" href="/index.php?title=Special:RecentChanges&feed=atom" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=mediawiki.legacy.commonPrint%2Cshared%7Cskins.monobook&only=styles&skin=monobook&*" /> -<!--[if lt IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE50Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE55Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 6]><link rel="stylesheet" href="/skins/monobook/IE60Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 7]><link rel="stylesheet" href="/skins/monobook/IE70Fixes.css?303" media="screen" /><![endif]--><meta name="ResourceLoaderDynamicStyles" content="" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=site&only=styles&skin=monobook&*" /> -<style>a:lang(ar),a:lang(ckb),a:lang(fa),a:lang(kk-arab),a:lang(mzn),a:lang(ps),a:lang(ur){text-decoration:none}a.new,#quickbar a.new{color:#ba0000} - -/* cache key: rasispdb:resourceloader:filter:minify-css:4:c88e2bcd56513749bec09a7e29cb3ffa */ -</style> -<script src="/load.php?debug=false&lang=en&modules=startup&only=scripts&skin=monobook&*"></script> -<script>if(window.mw){ - mw.config.set({"wgCanonicalNamespace": "", "wgCanonicalSpecialPageName": false, "wgNamespaceNumber": 0, "wgPageName": "ABI_compliance_checker", "wgTitle": "ABI Compliance Checker", "wgCurRevisionId": 8349, "wgArticleId": 2292, "wgIsArticle": true, "wgAction": "view", "wgUserName": null, "wgUserGroups": ["*"], "wgCategories": ["ABI Compliance Checker"], "wgBreakFrames": false, "wgRestrictionEdit": [], "wgRestrictionMove": []}); -} -</script><script>if(window.mw){ - mw.loader.load(["mediawiki.page.startup"]); -} -</script> -</head> -<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-ABI_compliance_checker action-view skin-monobook"> -<div id="globalWrapper"> -<div id="column-content"><div id="content"> - <a id="top"></a> - - <h1 id="firstHeading" class="firstHeading">ABI Compliance Checker</h1> - <div id="bodyContent"> - <div id="siteSub"></div> - <div id="contentSub"></div> - - <!-- start content --> -<div lang="en" dir="ltr" class="mw-content-ltr"><p><i>ABI Compliance Checker (ACC)</i> is a tool for checking backward <b>binary</b> and <b>source-level compatibility</b> of a C/C++ library. The tool checks header files and shared libraries of old and new versions and analyzes changes in API and ABI (ABI=API+compiler ABI) that may break binary and/or source compatibility: changes in calling stack, v-table changes, removed symbols, renamed fields, etc. Binary incompatibility may result in crashing or incorrect behavior of applications built with an old version of a library if they run on a new one. Source incompatibility may result in recompilation errors with a new library version. The tool is intended for developers of software libraries and maintainers of operating systems who are interested in ensuring backward compatibility, i.e. allow old applications to run or to be recompiled with newer library versions. -</p><p>See also: -</p> -<ul><li> <a rel="nofollow" class="external text" href="https://github.com/lvc/abi-dumper">ABI Dumper</a> -</li><li> <a rel="nofollow" class="external text" href="http://upstream-tracker.org/">Upstream Tracker</a> -</li><li> <a rel="nofollow" class="external text" href="http://pkgdiff.github.com/pkgdiff/">PkgDiff</a> -</li></ul> -<p><br /> -</p> -<table id="toc" class="toc"><tr><td><div id="toctitle"><h2>Contents</h2></div> -<ul> -<li class="toclevel-1 tocsection-1"><a href="#Downloads"><span class="tocnumber">1</span> <span class="toctext">Downloads</span></a> -<ul> -<li class="toclevel-2 tocsection-2"><a href="#Releases"><span class="tocnumber">1.1</span> <span class="toctext">Releases</span></a></li> -<li class="toclevel-2 tocsection-3"><a href="#Git"><span class="tocnumber">1.2</span> <span class="toctext">Git</span></a></li> -</ul> -</li> -<li class="toclevel-1 tocsection-4"><a href="#License"><span class="tocnumber">2</span> <span class="toctext">License</span></a></li> -<li class="toclevel-1 tocsection-5"><a href="#Supported_Platforms"><span class="tocnumber">3</span> <span class="toctext">Supported Platforms</span></a></li> -<li class="toclevel-1 tocsection-6"><a href="#System_Requirements"><span class="tocnumber">4</span> <span class="toctext">System Requirements</span></a></li> -<li class="toclevel-1 tocsection-7"><a href="#Detectable_Compatibility_Problems"><span class="tocnumber">5</span> <span class="toctext">Detectable Compatibility Problems</span></a> -<ul> -<li class="toclevel-2 tocsection-8"><a href="#Binary_Compatibility"><span class="tocnumber">5.1</span> <span class="toctext">Binary Compatibility</span></a></li> -<li class="toclevel-2 tocsection-9"><a href="#Source_Compatibility"><span class="tocnumber">5.2</span> <span class="toctext">Source Compatibility</span></a></li> -</ul> -</li> -<li class="toclevel-1 tocsection-10"><a href="#Installation"><span class="tocnumber">6</span> <span class="toctext">Installation</span></a></li> -<li class="toclevel-1 tocsection-11"><a href="#Usage"><span class="tocnumber">7</span> <span class="toctext">Usage</span></a> -<ul> -<li class="toclevel-2 tocsection-12"><a href="#Compare_Libraries"><span class="tocnumber">7.1</span> <span class="toctext">Compare Libraries</span></a></li> -<li class="toclevel-2 tocsection-13"><a href="#Create_ABI_Dumps"><span class="tocnumber">7.2</span> <span class="toctext">Create ABI Dumps</span></a></li> -<li class="toclevel-2 tocsection-14"><a href="#Usage_with_ABI_Dumper"><span class="tocnumber">7.3</span> <span class="toctext">Usage with ABI Dumper</span></a></li> -<li class="toclevel-2 tocsection-15"><a href="#Usage_as_a_Parser_of_API"><span class="tocnumber">7.4</span> <span class="toctext">Usage as a Parser of API</span></a></li> -<li class="toclevel-2 tocsection-16"><a href="#Compare_Operating_Systems"><span class="tocnumber">7.5</span> <span class="toctext">Compare Operating Systems</span></a></li> -<li class="toclevel-2 tocsection-17"><a href="#Check_Applications_Portability"><span class="tocnumber">7.6</span> <span class="toctext">Check Applications Portability</span></a></li> -<li class="toclevel-2 tocsection-18"><a href="#Command-Line_Options"><span class="tocnumber">7.7</span> <span class="toctext">Command-Line Options</span></a></li> -<li class="toclevel-2 tocsection-19"><a href="#Examples"><span class="tocnumber">7.8</span> <span class="toctext">Examples</span></a></li> -</ul> -</li> -<li class="toclevel-1 tocsection-20"><a href="#Tutorial"><span class="tocnumber">8</span> <span class="toctext">Tutorial</span></a></li> -<li class="toclevel-1 tocsection-21"><a href="#Report_Format"><span class="tocnumber">9</span> <span class="toctext">Report Format</span></a></li> -<li class="toclevel-1 tocsection-22"><a href="#Verdict_on_Compatibility"><span class="tocnumber">10</span> <span class="toctext">Verdict on Compatibility</span></a></li> -<li class="toclevel-1 tocsection-23"><a href="#Error_Codes"><span class="tocnumber">11</span> <span class="toctext">Error Codes</span></a></li> -<li class="toclevel-1 tocsection-24"><a href="#FAQ"><span class="tocnumber">12</span> <span class="toctext">FAQ</span></a></li> -<li class="toclevel-1 tocsection-25"><a href="#Similar_Tools"><span class="tocnumber">13</span> <span class="toctext">Similar Tools</span></a></li> -<li class="toclevel-1 tocsection-26"><a href="#Bugs"><span class="tocnumber">14</span> <span class="toctext">Bugs</span></a></li> -<li class="toclevel-1 tocsection-27"><a href="#Maintainers"><span class="tocnumber">15</span> <span class="toctext">Maintainers</span></a></li> -<li class="toclevel-1 tocsection-28"><a href="#Credits"><span class="tocnumber">16</span> <span class="toctext">Credits</span></a></li> -<li class="toclevel-1 tocsection-29"><a href="#Articles"><span class="tocnumber">17</span> <span class="toctext">Articles</span></a></li> -</ul> -</td></tr></table> -<h2> <span class="mw-headline" id="Downloads"> Downloads </span></h2> -<h3> <span class="mw-headline" id="Releases"> Releases </span></h3> -<p>All releases can be downloaded from <b><a href="Changes.html" title="ABI Compliance Checker Downloads">this page</a></b> or <b><a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/">github.com</a></b>. -</p><p>Latest release: <a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker/archive/1.99.9.tar.gz">1.99.9</a> -</p> -<h3> <span class="mw-headline" id="Git"> Git </span></h3> -<p>Read-only access to the latest development version:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> git clone <a rel="nofollow" class="external text" href="https://github.com/lvc/abi-compliance-checker">git://github.com/lvc/abi-compliance-checker.git</a>  </code><br /> -</p> -<h2> <span class="mw-headline" id="License"> License </span></h2> -<p>This program is free software. You may use, redistribute and/or modify it under the terms of either the <b>GNU GPL</b> or <b>LGPL</b>. -</p> -<h2> <span class="mw-headline" id="Supported_Platforms"> Supported Platforms </span></h2> -<p>GNU/Linux, FreeBSD, Mac OS X, MS Windows, Haiku/BeOS. -</p> -<h2> <span class="mw-headline" id="System_Requirements"> System Requirements </span></h2> -<ul><li><b>Linux, FreeBSD</b> -<ul><li> <a rel="nofollow" class="external text" href="http://gcc.gnu.org/">G++</a> (3.0-4.7, 4.8.3, recommended 4.5 or newer) -</li><li> <a rel="nofollow" class="external text" href="http://www.gnu.org/software/binutils/">GNU Binutils</a> (readelf, c++filt, objdump) -</li><li> <a rel="nofollow" class="external text" href="http://www.perl.org/">Perl 5</a> (5.8 or newer) -</li><li> <a rel="nofollow" class="external text" href="http://ctags.sourceforge.net/">Ctags</a> (5.8 or newer) -</li><li> WARNING: if you are using ccache program (i.e. gcc points to /usr/lib/ccache/gcc) then it should be newer than 3.1.2 or disabled. -</li></ul> -</li></ul> -<ul><li><b>Mac OS X</b> -<ul><li> <a rel="nofollow" class="external text" href="http://developer.apple.com/technologies/tools/xcode.html">Xcode</a> (gcc, c++filt, nm, otool) -</li><li> <a rel="nofollow" class="external text" href="http://ctags.sourceforge.net/">Ctags</a> (5.8 or newer) -</li></ul> -</li></ul> -<ul><li><b>MS Windows</b> -<ul><li> <a rel="nofollow" class="external text" href="http://www.mingw.org/">MinGW</a> (3.0-4.7, recommended 4.5 or newer) -</li><li> MS Visual C++ (dumpbin, undname, cl) -</li><li> <a rel="nofollow" class="external text" href="http://www.activestate.com/activeperl">Active Perl 5</a> (5.8 or newer) -</li><li> Sigcheck v1.71 or newer -</li><li> <a rel="nofollow" class="external text" href="http://ctags.sourceforge.net/">Ctags</a> (5.8 or newer) -</li><li> Info-ZIP 3.0 (zip, unzip) -</li><li> Add tool locations to the PATH environment variable -</li><li> Run vsvars32.bat script (C:\Microsoft Visual Studio 9.0\Common7\Tools\) -</li></ul> -</li></ul> -<h2> <span class="mw-headline" id="Detectable_Compatibility_Problems"> Detectable Compatibility Problems </span></h2> -<p>The tool searches for the following list of changes in the API that may break <b>binary/source-level</b> compatibility. See <a rel="nofollow" class="external text" href="#Articles" title="ABI Compliance Checker">this list</a> of articles for more info. -</p> -<h3> <span class="mw-headline" id="Binary_Compatibility"> Binary Compatibility </span></h3> -<ul><li> <b>Removed Symbols</b> (functions, global data) -</li><li> <b>Problems with Data Types</b> -<ul><li> <b>Structures</b> and <b>Classes</b> -<ul><li> added/removed fields (change of a memory layout) -</li><li> change of size -</li><li> changed order of fields -</li><li> change of a field type -</li><li> changes in fields (recursive analysis) -</li></ul> -</li><li> <b>Classes</b> -<ul><li> added/removed virtual functions (change of a v-table layout) -</li><li> change of virtual function position -</li><li> overridden virtual functions -</li><li> added/removed base classes -</li><li> changes in base classes (recursive analysis) -</li></ul> -</li><li> <b>Unions</b> -<ul><li> added/removed fields -</li><li> change of size -</li><li> change of a field type -</li><li> changes in fields (recursive analysis) -</li></ul> -</li><li> <b>Enumerations</b> -<ul><li> change of a member value -</li><li> removed/renamed members -</li></ul> -</li></ul> -</li><li> <b>Problems with Symbols</b> -<ul><li> <b>Stack Frame</b> -<ul><li> added/removed parameters -</li><li> change of a parameter/return value type -</li><li> change of default parameter value -</li><li> renamed parameters -</li></ul> -</li><li> <b>Other</b> -<ul><li> incorrect version change -</li><li> changed attributes (const, volatile, static, etc.) -</li></ul> -</li></ul> -</li><li> <b>Problems with Constants</b> (#defines) -<ul><li> changed value -</li></ul> -</li><li> <b>Problems with Implementation</b> -<ul><li> changes in disassembled binary code -</li></ul> -</li></ul> -<h3> <span class="mw-headline" id="Source_Compatibility"> Source Compatibility </span></h3> -<ul><li> <b>Removed Symbols</b> (functions, global data) -</li><li> <b>Problems with Data Types</b> -<ul><li> <b>Structures</b>, <b>Classes</b> and <b>Unions</b> -<ul><li> removed/renamed fields -</li><li> change of a field type -</li><li> changes in fields (recursive analysis) -</li></ul> -</li><li> <b>Classes</b> -<ul><li> added/removed base classes -</li><li> change access level of a field or method -</li><li> added pure virtual methods -</li></ul> -</li><li> <b>Enumerations</b> -<ul><li> removed/renamed members -</li></ul> -</li></ul> -</li><li> <b>Problems with Symbols</b> -<ul><li> <b>Parameters</b> -<ul><li> added/removed parameters -</li><li> change of a parameter type -</li><li> removed default value -</li></ul> -</li><li> <b>Other</b> -<ul><li> change of return value type -</li><li> changed attributes (const, static, etc.) -</li></ul> -</li></ul> -</li><li> <b>Problems with Constants</b> (#defines) -<ul><li> changed value -</li></ul> -</li></ul> -<p><br /> -You can see detailed problem descriptions in the visual interactive HTML-format compatibility report (see <a rel="nofollow" class="external text" href="http://upstream-tracker.org/compat_reports/mysql++/3.0.9_to_3.1.0/compat_report.html">this example</a>) generated by the tool. -</p> -<h2> <span class="mw-headline" id="Installation"> Installation </span></h2> -<p>The tool is <b>ready-to-use</b> after extracting the archive. You can also use a <b>Makefile</b> to install the tool into the system:<br /> -<code style="border: dashed 1px gray; background-color: #f0f0f0;"> cd abi-compliance-checker-x.y.z/ </code><br /><br /> -<code style="border: dashed 1px gray; background-color: #f0f0f0;"> sudo perl Makefile.pl -install --prefix=PREFIX [/usr, /usr/local, ...] </code> -</p><p>This command will install an <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker </code> program in the <code style="border: dashed 1px gray; background-color: #f0f0f0;"> PREFIX/bin </code> system directory and private modules into the <code style="border: dashed 1px gray; background-color: #f0f0f0;"> PREFIX/share </code>. -</p><p>To verify that the tool is installed correctly and it works on your host run:<br /> -<code style="border: dashed 1px gray; background-color: #f0f0f0;"> cd tmp/ </code><br /><br /> -<code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -test </code><br /><br /> -</p> -<h2> <span class="mw-headline" id="Usage"> Usage </span></h2> -<p>For using the tool, you should provide the <a href="Descriptor.html" title="Library Descriptor"><b>XML descriptors</b></a> for two library versions: <a href="Descriptor.html" title="Library Descriptor"><b>v1.xml</b></a> and <a href="Descriptor.html" title="Library Descriptor"><b>v2.xml</b></a> files. Library descriptor is a simple XML-file that specifies version number, paths to header files and shared libraries and other optional information. An example of the descriptor is the following (0.3.4.xml): -</p> -<pre><span style="color:Green;"><version></span> - 0.3.4 -<span style="color:Green;"></version></span> - -<span style="color:Green;"><headers></span> - /usr/local/libssh/0.3.4/include/ -<span style="color:Green;"></headers></span> - -<span style="color:Green;"><libs></span> - /usr/local/libssh/0.3.4/lib/ -<span style="color:Green;"></libs></span> -</pre> -<h3> <span class="mw-headline" id="Compare_Libraries"> Compare Libraries </span></h3> -<p>Command to compare two versions of a library:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -lib <i>NAME</i> -old <i><a href="Descriptor.html" title="Library Descriptor">V1.xml</a></i> -new <i><a href="Descriptor.html" title="Library Descriptor">V2.xml</a></i> </code><br /><br /> -The compatibility report will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> compat_reports/<i>NAME</i>/<i>V1</i>_to_<i>V2</i>/compat_report.html </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Create_ABI_Dumps"> Create ABI Dumps </span></h3> -<p>The library ABI is a representation of the library API at the binary level. The ABI dump is a dump of the model of the ABI used in the tool. -</p><p>The ABI dump consists of: -</p> -<ul><li> Types Information -<ul><li> Attributes (name, size, header, access, base types, etc.) -</li><li> Fields (name, type, size, position, alignment, access, specifiers, etc.) -</li><li> V-table structure (offsets, entries) -</li><li> Etc. -</li></ul> -</li><li> Symbols Information -<ul><li> Attributes (name, mangled name, header, access, specifiers, etc.) -</li><li> Parameters (name, type, position, alignment, etc.) -</li><li> Etc. -</li></ul> -</li><li> Etc. -</li></ul> -<p>The ABI dump can be used to create a snapshot of a library ABI in the particular environment and then compare it with any other state of the ABI changed due to changes in the environment (compiler version, external libraries, etc.) or changes in the library API (header files). The typical case is the comparing of two versions of the same library that require incompatible states of the environment (i.e. these versions cannot be installed simultaneously). In this case one can create a dump for one version of the library and then switch the environment and create ABI dump for other version of the library. Two ABI dumps can be compared by the tool to create the API compatibility report. -</p><p>To create an ABI dump use <a href="Options.html" title="ABI Compliance Checker Options">-dump</a> option:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -lib <i>NAME</i> -dump <i><a href="Descriptor.html" title="Library Descriptor">VER.xml</a></i> </code><br /><br /> -The ABI dump will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi_dumps/<i>NAME</i>/<i>NAME</i>_<i>VER</i>.abi.tar.gz </code><br /><br /> -To compare ABI dumps pass them as the descriptors:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -lib <i>NAME</i> -old <i>V1.abi.tar.gz</i> -new <i>V2.abi.tar.gz</i> </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Usage_with_ABI_Dumper"> Usage with ABI Dumper </span></h3> -<p>Library should be compiled with <b>-g</b> option to contain DWARF debug info. -</p><p>Create ABI dumps for both library versions using the <a rel="nofollow" class="external text" href="https://github.com/lvc/abi-dumper">ABI Dumper</a> tool: -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-dumper OLD.so -o ABI-0.dump -lver 0 </code><br /><br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-dumper NEW.so -o ABI-1.dump -lver 1 </code><br /><br /> -</p><p>Compare ABI dumps: -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -l NAME -old ABI-0.dump -new ABI-1.dump </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Usage_as_a_Parser_of_API"> Usage as a Parser of API </span></h3> -<p>The tool can be used as a parser of C/C++ API. Use <a href="Options.html" title="ABI Compliance Checker Options">-dump</a> and <a href="Options.html" title="ABI Compliance Checker Options">-xml</a> options to create ABI dump in the XML format:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -lib <i>NAME</i> -dump <i><a href="Descriptor.html" title="Library Descriptor">VER.xml</a></i> -xml </code><br /><br /> -The ABI dump will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi_dumps/<i>NAME</i>/<i>NAME</i>_<i>VER</i>.abi.tar.gz </code><br /><br /> -You can use additional <a href="Options.html" title="ABI Compliance Checker Options">-stdout</a> option to print ABI dump on the screen instead of creating gzipped file:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -lib <i>NAME</i> -dump <i><a href="Descriptor.html" title="Library Descriptor">VER.xml</a></i> -xml -stdout </code><br /><br /> -</p><p>See examples of ABI dumps for MeeGo Touch library in <a href="http://ispras.linuxbase.org/images/2/2a/MeeGoTouch_XML.abi.tar.gz" class="internal" title="MeeGoTouch XML.abi.tar.gz">XML</a> and <a href="http://ispras.linuxbase.org/images/4/47/MeeGoTouch.abi.tar.gz" class="internal" title="MeeGoTouch.abi.tar.gz">Perl</a> (default) formats. -<br /> -</p> -<h3> <span class="mw-headline" id="Compare_Operating_Systems"> Compare Operating Systems </span></h3> -<p>The detailed explanation on how to check compatibility between operating systems you can read on <b><a href="SysCheck/Usage.html" title="Operating Systems Compatibility">this page</a></b>. -</p><p>See current test results for <b>Symbian</b>, <b>Windows</b>, <b>MeeGo</b> and <b>Maemo</b> on <b><a rel="nofollow" class="external text" href="http://upstream-tracker.org/compatibility/index.html">this page</a></b>. -</p> -<h3> <span class="mw-headline" id="Check_Applications_Portability"> Check Applications Portability </span></h3> -<p>The ACC tool can be used by independent software vendors (ISV) to check applications portability to new library versions by specifying of its binary using <a href="Options.html" title="ABI Compliance Checker Options">-app</a> option:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -lib <i>NAME</i> -old <i><a href="Descriptor.html" title="Library Descriptor">V1.xml</a></i> -new <i><a href="Descriptor.html" title="Library Descriptor">V2.xml</a></i> -app <i>APP</i> </code> -</p><p>Found issues can be taken into account when adapting the application to a new library version. -</p> -<h3> <span class="mw-headline" id="Command-Line_Options"> Command-Line Options </span></h3> -<p>See the list of all options on <b><a href="Options.html" title="ABI Compliance Checker Options">this page</a></b>. -</p><p>Up-to-date list of all supported options can be obtained by this command: -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker --info </code><br /> -</p><p>Most useful options: -</p> -<ul><li> <a href="Options.html" title="ABI Compliance Checker Options">-debug</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-extra-info</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-dump</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-tolerance</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-headers-only</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-xml</a> -</li><li> <a href="Options.html" title="ABI Compliance Checker Options">-test</a> -</li></ul> -<h3> <span class="mw-headline" id="Examples"> Examples </span></h3> -<p>Check the libssh library versions for ABI compatibility:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -l libssh -old <a href="Descriptor.html" title="Library Descriptor">0.3.4.xml</a> -new <a href="Descriptor.html" title="Library Descriptor">0.4.0.xml</a> </code><br /><br /> -The compatibility report will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> compat_reports/libssh/0.3.4_to_0.4.0/compat_report.html </code><br /><br /> -Dump library ABI:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -l libssh -dump <a href="Descriptor.html" title="Library Descriptor">0.3.4.xml</a> </code><br /><br /> -The ABI will be dumped to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi_dumps/libssh/libssh_0.3.4.abi.tar.gz </code><br /><br /> -Use previously dumped ABI:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -l libssh -old libssh_0.3.4.abi.tar.gz -new libssh_0.4.0.abi.tar.gz </code><br /><br /> -Check client application portability between libssh versions:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -l libssh -old <a href="Descriptor.html" title="Library Descriptor">0.3.4.xml</a> -new <a href="Descriptor.html" title="Library Descriptor">0.4.0.xml</a> -app /usr/bin/csync </code><br /><br /> -</p> -<h2> <span class="mw-headline" id="Tutorial"> Tutorial </span></h2> -<p>An excellent tutorial <a rel="nofollow" class="external text" href="http://blog.famillecollet.com/post/2010/06/20/ABI-%3A-stability-check">"ABI: stability check"</a> is available at Les RPM de Remi Blog. See also <a rel="nofollow" class="external text" href="http://sourceware.org/glibc/wiki/Testing/ABI_checker">ABI Compliance Checker Notes</a> at glibc wiki. -</p> -<h2> <span class="mw-headline" id="Report_Format"> Report Format </span></h2> -<p>The tool supports two formats of a compatibility report: visual interactive HTML (default) and XML. To generate XML report you should specify <a href="Options.html" title="ABI Compliance Checker Options">-xml</a> additional option. -</p><p>The HTML-format compatibility report consists of: -</p> -<ul><li> <b>Test Info</b> - The library name and compared version numbers. Environment info: GCC version and CPU type; -</li><li> <b>Test Results</b> - Verdict on compatibility. Number of header files, shared libraries, symbols and data types checked by the tool; -</li><li> <b>Problem Summary</b> - Classification of compatibility problems; -</li><li> <b>Added Symbols</b> - The list of added symbols; -</li><li> <b>Removed Symbols</b> - The list of removed symbols; -</li><li> <b>Problems with Data Types</b> - The list of compatibility problems caused by changes in data types (divided by the severity level: High, Medium and Low). List of affected symbols; -</li><li> <b>Problems with Symbols</b> - The list of compatibility problems caused by changes in symbol parameters or attributes (divided by the severity level); -</li><li> <b>Problems with Constants</b> - The list of changed constants (#defines); -</li><li> <b>Other Changes in Data Types</b> - The list of compatible changes in data types; -</li><li> <b>Other Changes in Symbols</b> - The list of compatible changes in symbols; -</li><li> <b>Problems with Implementation</b> - The list of changes in disassembled binary code. Use <a href="Options.html" title="ABI Compliance Checker Options">-check-implementation</a> option to enable this section. -</li></ul> -<p>Examples of HTML-format report: -</p> -<ul><li> NetCDF: 4.0.1 to 4.1.1 API compatibility <a rel="nofollow" class="external text" href="http://upstream-tracker.org/compat_reports/netcdf/4.0.1_to_4.1.1/compat_report.html">report</a> -</li><li> MySQL++: 3.0.9 to 3.1.0 binary compatibility <a rel="nofollow" class="external text" href="http://upstream-tracker.org/compat_reports/mysql++/3.0.9_to_3.1.0/abi_compat_report.html">report</a> -</li><li> libssh: 0.3.4 to 0.4.0 binary compatibility <a rel="nofollow" class="external text" href="http://upstream-tracker.org/compat_reports/libssh/0.3.4_to_0.4.0/abi_compat_report.html">report</a> -</li></ul> -<h2> <span class="mw-headline" id="Verdict_on_Compatibility"> Verdict on Compatibility </span></h2> -<p>If the tool detected problems with high or medium level of severity or at least one removed symbol then the compatibility verdict is <b>incompatible</b> (otherwise <b>compatible</b>). Low-severity problems can be considered as <b>warnings</b> and don't affect the compatibility verdict unless the <a href="Options.html" title="ABI Compliance Checker Options">-strict</a> option is specified. -</p> -<h2> <span class="mw-headline" id="Error_Codes"> Error Codes </span></h2> -<table class="wikitable"> -<tr> -<th> Code -</th> -<th> Meaning -</th></tr> -<tr align="left"> -<td> 0 -</td> -<td> Compatible. The tool has run without any errors. -</td></tr> -<tr align="left"> -<td> 1 -</td> -<td> Incompatible. The tool has run without any errors. -</td></tr> -<tr align="left"> -<td> 2 -</td> -<td> Common error code (undifferentiated). -</td></tr> -<tr align="left"> -<td> 3 -</td> -<td> A system command is not found. -</td></tr> -<tr align="left"> -<td> 4 -</td> -<td> Cannot access input files. -</td></tr> -<tr align="left"> -<td> 5 -</td> -<td> Cannot compile header files. -</td></tr> -<tr align="left"> -<td> 6 -</td> -<td> Headers have been compiled with minor errors. -</td></tr> -<tr align="left"> -<td> 7 -</td> -<td> Invalid input ABI dump. -</td></tr> -<tr align="left"> -<td> 8 -</td> -<td> Unsupported version of input ABI dump. -</td></tr> -<tr align="left"> -<td> 9 -</td> -<td> Cannot find a module. -</td></tr> -<tr align="left"> -<td> 10 -</td> -<td> Empty intersection between headers and shared objects. -</td></tr> -<tr align="left"> -<td> 11 -</td> -<td> Empty set of symbols in headers. -</td></tr></table> -<h2> <span class="mw-headline" id="FAQ"> FAQ </span></h2> -<ul><li> <b>What is an ABI and how does it differ from an API?</b> -</li></ul> -<p>An Application Binary Interface (ABI) is the set of supported run-time interfaces provided by a software component or set of components for applications to use, whereas an Application Programming Interface (API) is the set of build-time interfaces. The ABI may be defined by the formula: -</p> -<pre> ABI = API + compiler ABI -</pre> -<ul><li> <b>Why does this tool need both shared libraries and header files to check ABI compliance?</b> -</li></ul> -<p>Without header files it is impossible to determine public symbols in ABI and data type definitions. Without shared libraries it is impossible to determine exported symbols in the ABI of the target library and also impossible to detect added/removed symbols. -</p> -<h2> <span class="mw-headline" id="Similar_Tools"> Similar Tools </span></h2> -<ol><li> <b>icheck</b> - C interface ABI/API checker -</li><li> <b>BCS</b> - The Symbian binary compatibility suite -</li><li> <b>shlib-compat</b> - ABI compatibility checker that uses DWARF debug info -</li><li> <b>qbic</b> - A tool to check for binary incompatibilities in Qt4 Toolkit -</li><li> <b>chkshlib</b>, <b>cmpdylib</b>, <b>cmpshlib</b> - Tools to compare binary symbols -</li></ol> -<h2> <span class="mw-headline" id="Bugs"> Bugs </span></h2> -<p>Please send your bug reports, feature requests and questions to the <a rel="nofollow" class="external text" href="mailto:aponomarenko@rosalab.ru">the maintainer</a>, post to <a rel="nofollow" class="external text" href="http://forge.ispras.ru/projects/abi-compliance-checker">issue tracker</a> or <a rel="nofollow" class="external text" href="https://groups.google.com/forum/#!forum/lvc-tools">mailing list</a>. -</p> -<h2> <span class="mw-headline" id="Maintainers"> Maintainers </span></h2> -<p>The tool was originally developed by the <a rel="nofollow" class="external text" href="http://linuxtesting.org">Russian Linux Verification Center</a> at <a href="http://ispras.linuxbase.org/index.php/ISP_RAS_Company_Profile" title="ISP RAS Company Profile">ISPRAS</a> and since <b>1.93</b> version it's developed by the <a rel="nofollow" class="external text" href="http://www.rosalab.com/">ROSA Laboratory</a> in Russia. <a rel="nofollow" class="external text" href="http://www.linkedin.com/pub/andrey-ponomarenko/67/366/818">Andrey Ponomarenko</a> is the leader of this project. -</p> -<h2> <span class="mw-headline" id="Credits"> Credits </span></h2> -<p>We would like to thank <a href="http://ispras.linuxbase.org/index.php/Thanks" title="Thanks">everyone</a> who has contributed to the success of this project! -</p> -<h2> <span class="mw-headline" id="Articles"> Articles </span></h2> -<p>Here is the list of articles about shared libraries and binary compatibility: -</p> -<ol><li> <a rel="nofollow" class="external text" href="http://techbase.kde.org/Policies/Binary_Compatibility_Issues_With_C++"><b>“Binary Compatibility Issues With C++”</b></a>, KDE TechBase -</li><li> <a rel="nofollow" class="external text" href="http://techbase.kde.org/Policies/Binary_Compatibility_Examples"><b>“Binary Compatibility Examples”</b></a>, KDE TechBase -</li><li> <a rel="nofollow" class="external text" href="http://refspecs.linux-foundation.org/cxxabi-1.83.html"><b>"Itanium C++ ABI"</b></a>, linux-foundation.org -</li><li> <a rel="nofollow" class="external text" href="http://www.ros.org/reps/rep-0009.html"><b>"ABI Compatibility"</b></a>, Josh Faust -</li><li> <a rel="nofollow" class="external text" href="http://blog.famillecollet.com/post/2010/06/20/ABI-%3A-stability-check"><b>"ABI : stability check"</b></a>, Les RPM de Remi - Blog -</li><li> <a rel="nofollow" class="external text" href="http://www.agner.org/optimize/calling_conventions.pdf"><b>“Calling conventions for different C++ compilers and operating systems”</b></a>, Agner Fog -</li><li> <a rel="nofollow" class="external text" href="http://www.angelcode.com/dev/callconv/callconv.html"><b>"Calling conventions on the x86 platform"</b></a>, Andreas Jonsson -</li><li> <a rel="nofollow" class="external text" href="http://labs.qt.nokia.com/2009/08/12/some-thoughts-on-binary-compatibility/"><b>“Some thoughts on binary compatibility”</b></a>, Thiago Macieira -</li><li> <a rel="nofollow" class="external text" href="http://syrcose.ispras.ru/2009/files/02_paper.pdf"><b>"Binary Compatibility of C++ shared libraries on GNU/Linux"</b></a>, Pavel Shved, Denis Silakov -</li><li> <a rel="nofollow" class="external text" href="http://www.usenix.org/publications/library/proceedings/als00/2000papers/papers/full_papers/browndavid/browndavid_html/"><b>"Library Interface Versioning in Solaris and Linux"</b></a>, David J. Brown and Karl Runge -</li><li> <a rel="nofollow" class="external text" href="http://docs.hp.com/en/950/v4vers.pdf"><b>"Steps to Version Your Shared Library"</b></a>, hp.com -</li><li> <a rel="nofollow" class="external text" href="http://developer.apple.com/tools/mpw-tools/compilers/docs/abi.html"><b>"Macintosh C/C++ ABI Overview"</b></a>, developer.apple.com -</li><li> <a rel="nofollow" class="external text" href="http://chadaustin.me/cppinterface.html"><b>“Binary-compatible C++ Interfaces”</b></a>, Chad Austin -</li><li> <a rel="nofollow" class="external text" href="http://gcc.gnu.org/onlinedocs/libstdc++/manual/abi.html"><b>"ABI Policy and Guidelines"</b></a>, gnu.org -</li><li> <a rel="nofollow" class="external text" href="http://gcc.gnu.org/onlinedocs/gcc/Compatibility.html"><b>"Binary Compatibility"</b></a>, gnu.org -</li><li> <a rel="nofollow" class="external text" href="http://developers.sun.com/solaris/articles/CC_abi/CC_abi_content.html"><b>"Stability of the C++ ABI: Evolution of a Programing Language"</b></a>, Stephen Clamage -</li><li> <a rel="nofollow" class="external text" href="http://www.netfort.gr.jp/~dancer/column/libpkg-guide/libpkg-guide.html#binarycompat"><b>"When binary compatibility breaks"</b></a>, Debian Library Packaging guide -</li><li> <a rel="nofollow" class="external text" href="http://techbase.kde.org/Policies/Library_Code_Policy"><b>“Library Code Policy”</b></a>, KDE TechBase -</li><li> <a rel="nofollow" class="external text" href="http://people.redhat.com/drepper/dsohowto.pdf"><b>"How To Write Shared Libraries"</b></a>, Ulrich Drepper -</li><li> <a rel="nofollow" class="external text" href="http://lookup.computerlanguage.com/host_app/search?cid=C000401&term=ABI"><b>"Application Binary Interface"</b></a>, Computer Desktop Encyclopedia -</li><li> <a rel="nofollow" class="external text" href="http://www.linux.org/docs/ldp/howto/Program-Library-HOWTO/shared-libraries.html"><b>“Program Library HOWTO”</b></a>, linux.org -</li><li> <a rel="nofollow" class="external text" href="http://plan99.net/~mike/writing-shared-libraries.html"><b>“Writing shared libraries”</b></a>, Mike Hearn -</li><li> <a rel="nofollow" class="external text" href="http://www.ayukov.com/essays/linuxdll.html"><b>"Shared libraries in Linux: growing pains or fundamental problem?"</b></a>, Sergey Ayukov -</li><li> <a rel="nofollow" class="external text" href="http://2f.ru/holy-wars/fbc.html"><b>“What's the Fragile Base Class (FBC) Problem?”</b></a>, Peter Potrebic -</li><li> <a rel="nofollow" class="external text" href="http://c2.com/cgi/wiki?FragileBinaryInterfaceProblem"><b>“Fragile Binary Interface Problem”</b></a>, Steven Newton -</li><li> <a rel="nofollow" class="external text" href="http://www.oocities.org/mrshrap/linker.html"><b>“The amazing world of library incompatibility”</b></a>, oocities.org -</li><li> <a rel="nofollow" class="external text" href="http://library.forum.nokia.com/index.jsp?topic=/S60_5th_Edition_Cpp_Developers_Library/GUID-35228542-8C95-4849-A73F-2B4F082F0C44/sdk/doc_source/faqSDK/faq_0444.html"><b>“The Theory of Binary Compatibility”</b></a>, Forum.Nokia -</li><li> <a rel="nofollow" class="external text" href="http://library.developer.nokia.com/index.jsp?topic=/S60_5th_Edition_Cpp_Developers_Library/GUID-35228542-8C95-4849-A73F-2B4F082F0C44/sdk/doc_source/ToolsAndUtilities94/BuildTools/bc.guide.html"><b>“How to control binary compatibility”</b></a>, Forum.Nokia -</li><li> <a rel="nofollow" class="external text" href="http://www.elpauer.org/?p=230"><b>“ABI compatibility in C++”</b></a>, elpauer.org -</li><li> <a rel="nofollow" class="external text" href="http://blogs.gentoo.org/mgorny/2012/08/20/the-impact-of-cxx-templates-on-library-abi/"><b>“The impact of C++ templates on library ABI”</b></a>, Michał Górny -</li><li> <a rel="nofollow" class="external text" href="http://sourceware.org/glibc/wiki/Testing/ABI_checker"><b>“ABI Compliance Checker Notes”</b></a>, sourceware.org -</li><li> <a rel="nofollow" class="external text" href="http://developer.symbian.org/wiki/index.php/Preserving_Compatibility"><b>"Preserving Compatibility"</b></a>, symbian.org -</li><li> <a rel="nofollow" class="external text" href="http://doi.ieeecomputersociety.org/10.1109/VALID.2010.27"><b>"Automated Verification of Shared Libraries for Backward Binary Compatibility"</b></a>, A. Ponomarenko and V. Rubanov, VALID 2010 -</li><li> <a rel="nofollow" class="external text" href="http://www.springerlink.com/content/905067689q7n0166/"><b>"Backward compatibility of software interfaces: Steps towards automatic verification"</b></a>, A. Ponomarenko and V. Rubanov, Programming and Computer Software 2012 -</li><li> <a rel="nofollow" class="external text" href="http://www.macieira.org/blog/2012/01/architectures-and-abis-detailed/"><b>"Architectures and ABIs detailed"</b></a>, Thiago Macieira's blog -</li><li> <a rel="nofollow" class="external text" href="http://accu.org/index.php/journals/1718"><b>"Interface Versioning in C++"</b></a>, ACCU -</li><li> <a rel="nofollow" class="external text" href="http://refspecs.freestandards.org/elf/gabi41.pdf"><b>"Generic ABI Standard"</b></a>, <a rel="nofollow" class="external text" href="http://refspecs.freestandards.org/elf/"><b>"ELF and ABI Standards"</b></a>, freestandards.org -</li><li> Processor ABI standards: <b><a rel="nofollow" class="external text" href="http://refspecs.freestandards.org/elf/abi386-4.pdf">Intel386</a></b>, <b><a rel="nofollow" class="external text" href="http://www.x86-64.org/documentation/abi.pdf">AMD64</a></b>, <b><a rel="nofollow" class="external text" href="http://infocenter.arm.com/help/topic/com.arm.doc.ihi0042d/IHI0042D_aapcs.pdf">ARM</a></b>, <b><a rel="nofollow" class="external text" href="http://refspecs.freestandards.org/elf/elfspec_ppc.pdf">PowerPC</a></b>, <b><a rel="nofollow" class="external text" href="http://download.boulder.ibm.com/ibmdl/pub/software/dw/linux390/docu/l390abi0.pdf">S/390</a></b>, <b><a rel="nofollow" class="external text" href="http://refspecs.freestandards.org/elf/IA64-SysV-psABI.pdf">Itanium</a></b>, <b><a rel="nofollow" class="external text" href="http://refspecs.freestandards.org/elf/mipsabi.pdf">MIPS</a></b>, <b><a rel="nofollow" class="external text" href="http://www.sparc.org/standards/psABI3rd.pdf">SPARC</a></b>, <b><a rel="nofollow" class="external text" href="http://refspecs.freestandards.org/elf/elf-pa.pdf">PA-RISK</a></b>, <b><a rel="nofollow" class="external text" href="http://www.linux-m32r.org/cmn/m32r/M32R-elf-abi.pdf">M32R</a></b> -</li><li> <a rel="nofollow" class="external text" href="http://science.webhostinggeeks.com/abi-compliance-checker"><b>Translation of this article to Serbo-Croatian</b></a>, Jovana Milutinovich -</li></ol> - -<!-- -NewPP limit report -Preprocessor node count: 148/1000000 -Post-expand include size: 0/2097152 bytes -Template argument size: 0/2097152 bytes -Expensive parser function count: 0/100 ---> - -<!-- Saved in parser cache with key rasispdb:pcache:idhash:2292-0!*!0!!en!*!* and timestamp 20140123092613 --> -</div></div></div></div></div></body></html>
\ No newline at end of file diff --git a/doc/SysCheck/Descriptor.html b/doc/SysCheck/Descriptor.html deleted file mode 100644 index 640fe4c..0000000 --- a/doc/SysCheck/Descriptor.html +++ /dev/null @@ -1,237 +0,0 @@ - -<!DOCTYPE html> -<html lang="en" dir="ltr" class="client-nojs"> -<head> -<title>Operating System Descriptor</title> -<meta charset="UTF-8" /> -<meta name="generator" content="MediaWiki 1.18.1" /> -<link rel="shortcut icon" href="/favicon.ico" /> -<link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="ISP_RAS (en)" /> -<link rel="EditURI" type="application/rsd+xml" href="http://ispras.linuxbase.org/api.php?action=rsd" /> -<link rel="alternate" type="application/atom+xml" title="ISP_RAS Atom feed" href="/index.php?title=Special:RecentChanges&feed=atom" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=mediawiki.legacy.commonPrint%2Cshared%7Cskins.monobook&only=styles&skin=monobook&*" /> -<!--[if lt IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE50Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE55Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 6]><link rel="stylesheet" href="/skins/monobook/IE60Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 7]><link rel="stylesheet" href="/skins/monobook/IE70Fixes.css?303" media="screen" /><![endif]--><meta name="ResourceLoaderDynamicStyles" content="" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=site&only=styles&skin=monobook&*" /> -<style>a:lang(ar),a:lang(ckb),a:lang(fa),a:lang(kk-arab),a:lang(mzn),a:lang(ps),a:lang(ur){text-decoration:none}a.new,#quickbar a.new{color:#ba0000} - -/* cache key: rasispdb:resourceloader:filter:minify-css:4:c88e2bcd56513749bec09a7e29cb3ffa */ -</style> -<script src="/load.php?debug=false&lang=en&modules=startup&only=scripts&skin=monobook&*"></script> -<script>if(window.mw){ - mw.config.set({"wgCanonicalNamespace": "", "wgCanonicalSpecialPageName": false, "wgNamespaceNumber": 0, "wgPageName": "Operating_System_Descriptor", "wgTitle": "Operating System Descriptor", "wgCurRevisionId": 7476, "wgArticleId": 2657, "wgIsArticle": true, "wgAction": "view", "wgUserName": null, "wgUserGroups": ["*"], "wgCategories": ["ABI Compliance Checker"], "wgBreakFrames": false, "wgRestrictionEdit": [], "wgRestrictionMove": []}); -} -</script><script>if(window.mw){ - mw.loader.load(["mediawiki.page.startup"]); -} -</script> -</head> -<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-Operating_System_Descriptor action-view skin-monobook"> -<div id="globalWrapper"> -<div id="column-content"><div id="content"> - <a id="top"></a> - - <h1 id="firstHeading" class="firstHeading">Operating System Descriptor</h1> - <div id="bodyContent"> - <div id="siteSub"></div> - <div id="contentSub"></div> - - <!-- start content --> -<div lang="en" dir="ltr" class="mw-content-ltr"><h2> <span class="mw-headline" id="Primary_Sections"> Primary Sections </span></h2> -<pre> <span style="color:Green;"><name></span> - /* Name of the system */ - <span style="color:Green;"></name></span> - - <span style="color:Green;"><headers></span> - /* The list of paths to header files and/or - directories with header files, one per line */ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - /* The list of paths to shared libraries and/or - directories with shared libraries, one per line */ - <span style="color:Green;"></libs></span> -</pre> -<h2> <span class="mw-headline" id="Optional_Sections"> Optional Sections </span></h2> -<pre> <span style="color:Green;"><search_headers></span> - /* List of directories to be searched - for header files to automatically - generate include paths, one per line */ - <span style="color:Green;"></search_headers></span> - - <span style="color:Green;"><search_libs></span> - /* List of directories to be searched - for shared libraries to resolve - dependencies, one per line */ - <span style="color:Green;"></search_libs></span> - - <span style="color:Green;"><tools></span> - /* List of directories with tools used - for analysis (GCC toolchain), one per line */ - <span style="color:Green;"></tools></span> - - <span style="color:Green;"><cross_prefix></span> - /* GCC toolchain prefix. - Examples: - arm-linux-gnueabi - arm-none-symbianelf */ - <span style="color:Green;"></cross_prefix></span> - - <span style="color:Green;"><gcc_options></span> - /* Additional GCC options, - one per line */ - <span style="color:Green;"></gcc_options></span> -</pre> -<h2> <span class="mw-headline" id="Examples"> Examples </span></h2> -<ul><li> <b>Symbian^3</b> -</li></ul> -<pre> <span style="color:Green;"><name></span> - Symbian^3 - <span style="color:Green;"></name></span> - - <span style="color:Green;"><headers></span> - c:\Nokia\devices\Nokia_Symbian3_SDK_v1.0\epoc32\include\ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - c:\Nokia\devices\Nokia_Symbian3_SDK_v1.0\epoc32\release\armv5\lib\ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><tools></span> - c:\Program Files\CodeSourcery\Sourcery G++ Lite\bin\ - <span style="color:Green;"></tools></span> - - <span style="color:Green;"><cross_prefix></span> - arm-none-symbianelf - <span style="color:Green;"></cross_prefix></span> -</pre> -<ul><li> <b>S60 5th Edition</b> -</li></ul> -<pre> <span style="color:Green;"><name></span> - S60 5th Edition - <span style="color:Green;"></name></span> - - <span style="color:Green;"><headers></span> - c:\Nokia\devices\S60_5th_Edition_SDK_v1.0\epoc32\include\ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - c:\Nokia\devices\S60_5th_Edition_SDK_v1.0\epoc32\release\armv5\lib\ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><tools></span> - c:\Program Files\CSL Arm Toolchain\bin\ - <span style="color:Green;"></tools></span> - - <span style="color:Green;"><cross_prefix></span> - arm-none-symbianelf - <span style="color:Green;"></cross_prefix></span> -</pre> -<ul><li> <b>S60 3rd Edition</b> -</li></ul> -<pre> <span style="color:Green;"><name></span> - S60 3rd Edition - <span style="color:Green;"></name></span> - - <span style="color:Green;"><headers></span> - c:\Nokia\devices\S60_3rd_FP2_SDK_v1.1\epoc32\include - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - c:\Nokia\devices\S60_3rd_FP2_SDK_v1.1\epoc32\release\armv5\lib\ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><tools></span> - c:\Program Files\CSL Arm Toolchain\bin\ - <span style="color:Green;"></tools></span> - - <span style="color:Green;"><cross_prefix></span> - arm-none-symbianelf - <span style="color:Green;"></cross_prefix></span> -</pre> -<ul><li> <b>Windows SDK 7.1</b> -</li></ul> -<pre> <span style="color:Green;"><name></span> - Windows SDK 7.1 - <span style="color:Green;"></name></span> - - <span style="color:Green;"><headers></span> - c:\Program Files\Microsoft SDKs\Windows\v7.1\Include\ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - c:\Windows\system32\ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><tools></span> - c:\MinGW\bin\ - <span style="color:Green;"></tools></span> - - <span style="color:Green;"><gcc_options></span> - -D_WIN32_WINNT=0x0700 - <span style="color:Green;"></gcc_options></span> - - <span style="color:Green;"><search_headers></span> - c:\Program Files\Microsoft Visual Studio 9.0\VC\include\ - <span style="color:Green;"></search_headers></span> -</pre> -<ul><li> <b>Windows SDK 6.0</b> -</li></ul> -<pre> <span style="color:Green;"><name></span> - Windows SDK 6.0 - <span style="color:Green;"></name></span> - - <span style="color:Green;"><headers></span> - c:\Program Files\Microsoft SDKs\Windows\v6.0A\Include\ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - c:\Windows\system32\ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><tools></span> - c:\MinGW\bin\ - <span style="color:Green;"></tools></span> - - <span style="color:Green;"><gcc_options></span> - -D_WIN32_WINNT=0x0600 - <span style="color:Green;"></gcc_options></span> - - <span style="color:Green;"><search_headers></span> - c:\Program Files\Microsoft Visual Studio 9.0\VC\include\ - <span style="color:Green;"></search_headers></span> -</pre> -<ul><li> <b>Windows SDK 5.0</b> -</li></ul> -<pre> <span style="color:Green;"><name></span> - Windows SDK 5.0 - <span style="color:Green;"></name></span> - - <span style="color:Green;"><headers></span> - c:\Program Files\Microsoft SDKs\Windows\v5.0\Include\ - <span style="color:Green;"></headers></span> - - <span style="color:Green;"><libs></span> - c:\Windows\system32\ - <span style="color:Green;"></libs></span> - - <span style="color:Green;"><tools></span> - c:\MinGW\bin\ - <span style="color:Green;"></tools></span> - - <span style="color:Green;"><gcc_options></span> - -D_WIN32_WINNT=0x0500 - <span style="color:Green;"></gcc_options></span> -</pre> -<!-- -NewPP limit report -Preprocessor node count: 90/1000000 -Post-expand include size: 0/2097152 bytes -Template argument size: 0/2097152 bytes -Expensive parser function count: 0/100 ---> - -<!-- Saved in parser cache with key rasispdb:pcache:idhash:2657-0!*!*!!*!*!* and timestamp 20140123091759 --> -</div></div></div></div></div></body></html>
\ No newline at end of file diff --git a/doc/SysCheck/Examples.html b/doc/SysCheck/Examples.html deleted file mode 100644 index eb2fbca..0000000 --- a/doc/SysCheck/Examples.html +++ /dev/null @@ -1,243 +0,0 @@ - -<!DOCTYPE html> -<html lang="en" dir="ltr" class="client-nojs"> -<head> -<title>Operating Systems Compatibility Examples</title> -<meta charset="UTF-8" /> -<meta name="generator" content="MediaWiki 1.18.1" /> -<link rel="shortcut icon" href="/favicon.ico" /> -<link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="ISP_RAS (en)" /> -<link rel="EditURI" type="application/rsd+xml" href="http://ispras.linuxbase.org/api.php?action=rsd" /> -<link rel="alternate" type="application/atom+xml" title="ISP_RAS Atom feed" href="/index.php?title=Special:RecentChanges&feed=atom" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=mediawiki.legacy.commonPrint%2Cshared%7Cskins.monobook&only=styles&skin=monobook&*" /> -<!--[if lt IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE50Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE55Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 6]><link rel="stylesheet" href="/skins/monobook/IE60Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 7]><link rel="stylesheet" href="/skins/monobook/IE70Fixes.css?303" media="screen" /><![endif]--><meta name="ResourceLoaderDynamicStyles" content="" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=site&only=styles&skin=monobook&*" /> -<style>a:lang(ar),a:lang(ckb),a:lang(fa),a:lang(kk-arab),a:lang(mzn),a:lang(ps),a:lang(ur){text-decoration:none}a.new,#quickbar a.new{color:#ba0000} - -/* cache key: rasispdb:resourceloader:filter:minify-css:4:c88e2bcd56513749bec09a7e29cb3ffa */ -</style> -<script src="/load.php?debug=false&lang=en&modules=startup&only=scripts&skin=monobook&*"></script> -<script>if(window.mw){ - mw.config.set({"wgCanonicalNamespace": "", "wgCanonicalSpecialPageName": false, "wgNamespaceNumber": 0, "wgPageName": "Operating_Systems_Compatibility_Examples", "wgTitle": "Operating Systems Compatibility Examples", "wgCurRevisionId": 8059, "wgArticleId": 2656, "wgIsArticle": true, "wgAction": "view", "wgUserName": null, "wgUserGroups": ["*"], "wgCategories": ["ABI Compliance Checker"], "wgBreakFrames": false, "wgRestrictionEdit": [], "wgRestrictionMove": []}); -} -</script><script>if(window.mw){ - mw.loader.load(["mediawiki.page.startup"]); -} -</script> -</head> -<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-Operating_Systems_Compatibility_Examples action-view skin-monobook"> -<div id="globalWrapper"> -<div id="column-content"><div id="content"> - <a id="top"></a> - - <h1 id="firstHeading" class="firstHeading">Operating Systems Compatibility Examples</h1> - <div id="bodyContent"> - <div id="siteSub"></div> - <div id="contentSub"></div> - - <!-- start content --> -<div lang="en" dir="ltr" class="mw-content-ltr"><table id="toc" class="toc"><tr><td><div id="toctitle"><h2>Contents</h2></div> -<ul> -<li class="toclevel-1 tocsection-1"><a href="#Compatibility_of_Maemo_4.1.2_and_Maemo_5.0"><span class="tocnumber">1</span> <span class="toctext">Compatibility of Maemo 4.1.2 and Maemo 5.0</span></a> -<ul> -<li class="toclevel-2 tocsection-2"><a href="#Setup_Maemo_4.1.2"><span class="tocnumber">1.1</span> <span class="toctext">Setup Maemo 4.1.2</span></a></li> -<li class="toclevel-2 tocsection-3"><a href="#Dump_Maemo_4.1.2_ABI"><span class="tocnumber">1.2</span> <span class="toctext">Dump Maemo 4.1.2 ABI</span></a></li> -<li class="toclevel-2 tocsection-4"><a href="#Setup_Maemo_5.0"><span class="tocnumber">1.3</span> <span class="toctext">Setup Maemo 5.0</span></a></li> -<li class="toclevel-2 tocsection-5"><a href="#Dump_Maemo_5.0_ABI"><span class="tocnumber">1.4</span> <span class="toctext">Dump Maemo 5.0 ABI</span></a></li> -<li class="toclevel-2 tocsection-6"><a href="#Compare_ABI_Dumps"><span class="tocnumber">1.5</span> <span class="toctext">Compare ABI Dumps</span></a></li> -</ul> -</li> -<li class="toclevel-1 tocsection-7"><a href="#Compatibility_of_MeeGo_1.2_Core_and_MeeGo_1.2_Harmattan"><span class="tocnumber">2</span> <span class="toctext">Compatibility of MeeGo 1.2 Core and MeeGo 1.2 Harmattan</span></a> -<ul> -<li class="toclevel-2 tocsection-8"><a href="#Setup_MeeGo_1.2_Core"><span class="tocnumber">2.1</span> <span class="toctext">Setup MeeGo 1.2 Core</span></a></li> -<li class="toclevel-2 tocsection-9"><a href="#Dump_MeeGo_1.2_Core_ABI"><span class="tocnumber">2.2</span> <span class="toctext">Dump MeeGo 1.2 Core ABI</span></a></li> -<li class="toclevel-2 tocsection-10"><a href="#Setup_MeeGo_1.2_Harmattan"><span class="tocnumber">2.3</span> <span class="toctext">Setup MeeGo 1.2 Harmattan</span></a></li> -<li class="toclevel-2 tocsection-11"><a href="#Dump_MeeGo_1.2_Harmattan_ABI"><span class="tocnumber">2.4</span> <span class="toctext">Dump MeeGo 1.2 Harmattan ABI</span></a></li> -<li class="toclevel-2 tocsection-12"><a href="#Compare_ABI_Dumps_2"><span class="tocnumber">2.5</span> <span class="toctext">Compare ABI Dumps</span></a></li> -</ul> -</li> -<li class="toclevel-1 tocsection-13"><a href="#Compatibility_of_S60_5th_Edition_and_Symbian.5E3"><span class="tocnumber">3</span> <span class="toctext">Compatibility of S60 5th Edition and Symbian^3</span></a> -<ul> -<li class="toclevel-2 tocsection-14"><a href="#Setup_S60_5th_Edition_SDK"><span class="tocnumber">3.1</span> <span class="toctext">Setup S60 5th Edition SDK</span></a></li> -<li class="toclevel-2 tocsection-15"><a href="#Dump_S60_5th_Edition_ABI"><span class="tocnumber">3.2</span> <span class="toctext">Dump S60 5th Edition ABI</span></a></li> -<li class="toclevel-2 tocsection-16"><a href="#Setup_Symbian.5E3_SDK"><span class="tocnumber">3.3</span> <span class="toctext">Setup Symbian^3 SDK</span></a></li> -<li class="toclevel-2 tocsection-17"><a href="#Dump_Symbian.5E3_ABI"><span class="tocnumber">3.4</span> <span class="toctext">Dump Symbian^3 ABI</span></a></li> -<li class="toclevel-2 tocsection-18"><a href="#Compare_ABI_Dumps_3"><span class="tocnumber">3.5</span> <span class="toctext">Compare ABI Dumps</span></a></li> -</ul> -</li> -</ul> -</td></tr></table> -<h2> <span class="mw-headline" id="Compatibility_of_Maemo_4.1.2_and_Maemo_5.0"> Compatibility of Maemo 4.1.2 and Maemo 5.0 </span></h2> -<h3> <span class="mw-headline" id="Setup_Maemo_4.1.2"> Setup Maemo 4.1.2 </span></h3> -<p>Follow <a rel="nofollow" class="external text" href="http://maemo.org/development/sdks/maemo_4-1-2_diablo/">this tutorial</a> to install Maemo 4.1.2 SDK. -</p><p>Setup scratchbox for Maemo 4.1.2:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sudo /home/maemo/4.1.2/scratchbox/sbin/sbox_ctl start </code><br /><br /> -</p><p>Login to the Maemo 4.1.2:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> /home/maemo/4.1.2/scratchbox/login </code><br /><br /> -</p><p>Select the ARMEL target:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sb-conf select DIABLO_ARMEL </code><br /><br /> -</p><p>Install all devel packages:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> apt-get update </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> apt-cache search "\-dev"|awk '{print $1;}'>install.txt </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> for i in `cat install.txt`;do apt-get --force-yes -y install $i;done </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Dump_Maemo_4.1.2_ABI"> Dump Maemo 4.1.2 ABI </span></h3> -<p>Command to dump system ABI:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -dump-system "Maemo-4.1.2" -sysroot / </code><br /><br /> -</p><p>The system ABI dump will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_dumps/Maemo-4.1.2/arm/ </code><br /><br /> -</p><p>Exit and shutdown the scratchbox for Maemo 4.1.2:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> exit </code><br /><br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sudo /home/maemo/4.1.2/scratchbox/sbin/sbox_ctl stop </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Setup_Maemo_5.0"> Setup Maemo 5.0 </span></h3> -<p>Follow <a rel="nofollow" class="external text" href="http://wiki.maemo.org/Documentation/Maemo5_Final_Installation">this tutorial</a> to install Maemo 5.0 SDK. -</p><p>Login to the Maemo 5.0:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> /home/maemo/5.0/scratchbox/login </code><br /><br /> -</p><p>Select the ARMEL target:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sb-conf select FREMANTLE_ARMEL </code><br /><br /> -</p><p>Install all devel packages:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> apt-get update </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> apt-cache search "\-dev"|awk '{print $1;}'>install.txt </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> for i in `cat install.txt`;do apt-get --force-yes -y install $i;done </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Dump_Maemo_5.0_ABI"> Dump Maemo 5.0 ABI </span></h3> -<p>Command to dump the Maemo 5.0 ABI:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -dump-system "Maemo-5.0" -sysroot / </code><br /><br /> -</p><p>The system ABI dump will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_dumps/Maemo-5.0/arm/ </code><br /><br /> -</p><p>Exit and shutdown the scratchbox for Maemo 5.0:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> exit </code><br /><br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sudo /home/maemo/5.0/scratchbox/sbin/sbox_ctl stop </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Compare_ABI_Dumps"> Compare ABI Dumps </span></h3> -<p>Command to check Maemo 4.1.2 and Maemo 5.0 for backward compatibility:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -cmp-systems -d1 sys_dumps/Maemo-4.1.2/arm/ -d2 sys_dumps/Maemo-5.0/arm/ </code><br /><br /> -</p><p>The compatibility report will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_compat_reports/Maemo-4.1.2_to_Maemo-5.0/arm/<a rel="nofollow" class="external text" href="http://upstream-tracker.org/compatibility/Maemo_4.1.2_to_Maemo_5.0/arm/abi_compat_report.html">abi_compat_report.html</a> </code><br /><br /> -</p> -<h2> <span class="mw-headline" id="Compatibility_of_MeeGo_1.2_Core_and_MeeGo_1.2_Harmattan"> Compatibility of MeeGo 1.2 Core and MeeGo 1.2 Harmattan </span></h2> -<h3> <span class="mw-headline" id="Setup_MeeGo_1.2_Core"> Setup MeeGo 1.2 Core </span></h3> -<p>Follow <a rel="nofollow" class="external text" href="http://wiki.meego.com/MeeGo_1.0_Netbook_VirtualBox">this tutorial</a> to install Intel's MeeGo 1.2 on VirtualBox and enter to the system terminal. -</p><p>Install all devel packages:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> zypper search -u dev|awk '{print $2;}'|grep 'dev'>install.txt </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> for i in `cat install.txt`;do zypper -n install $i;done </code><br /><br /> -</p><p>Install G++ compiler:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> zypper install gcc-c++ </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Dump_MeeGo_1.2_Core_ABI"> Dump MeeGo 1.2 Core ABI </span></h3> -<p>Dump the MeeGo 1.2 ABI:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -dump-system "MeeGo-1.2-Core" -sysroot / </code><br /><br /> -</p><p>The system ABI dump will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_dumps/MeeGo-1.2-Core/x86/ </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Setup_MeeGo_1.2_Harmattan"> Setup MeeGo 1.2 Harmattan </span></h3> -<p>Follow <a rel="nofollow" class="external text" href="http://harmattan-dev.nokia.com/">this tutorial</a> to install MeeGo 1.2 Harmattan SDK. -</p><p>Setup scratchbox for MeeGo 1.2 Harmattan:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sudo /home/meego/1.2-harmattan/scratchbox/sbin/sbox_ctl start </code><br /><br /> -</p><p>Login to the MeeGo 1.2 Harmattan:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> /home/meego/1.2-harmattan/scratchbox/login </code><br /><br /> -</p><p>Select the X86 target:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sb-conf select HARMATTAN_X86 </code><br /><br /> -</p><p>Install all devel packages:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> apt-get update </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> apt-cache search '\-dev'|awk '{print $1;}'>install.txt </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> for i in `cat install.txt`;do apt-get --force-yes -y install $i;done </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Dump_MeeGo_1.2_Harmattan_ABI"> Dump MeeGo 1.2 Harmattan ABI </span></h3> -<p>Dump the MeeGo 1.2 Harmattan ABI:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -dump-system "MeeGo-1.2-Harmattan" -sysroot / </code><br /><br /> -</p><p>The system ABI dump will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_dumps/MeeGo-1.2-Harmattan/x86/ </code><br /><br /> -</p><p>Exit and shutdown the scratchbox for MeeGo 1.2 Harmattan:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> exit </code><br /><br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sudo /home/meego/1.2-harmattan/scratchbox/sbin/sbox_ctl stop </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Compare_ABI_Dumps_2"> Compare ABI Dumps </span></h3> -<p>Check MeeGo 1.2 Harmattan and Intel's MeeGo 1.2 for compatibility:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -cmp-systems -d1 sys_dumps/MeeGo-1.2-Core/x86/ -d2 sys_dumps/MeeGo-1.2-Harmattan/x86/ </code><br /><br /> -</p><p>The compatibility report will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_compat_reports/MeeGo-1.2-Core_to_MeeGo-1.2-Harmattan/x86/<a rel="nofollow" class="external text" href="http://upstream-tracker.org/compatibility/MeeGo_1.2_Core_to_MeeGo_1.2_Harmattan/x86/abi_compat_report.html">abi_compat_report.html</a> </code><br /><br /> -</p> -<h2> <span class="mw-headline" id="Compatibility_of_S60_5th_Edition_and_Symbian.5E3"> Compatibility of S60 5th Edition and Symbian^3 </span></h2> -<h3> <span class="mw-headline" id="Setup_S60_5th_Edition_SDK"> Setup S60 5th Edition SDK </span></h3> -<p>Follow <a rel="nofollow" class="external text" href="https://www.developer.nokia.com/Resources/Tools_and_downloads/Other/Symbian_SDKs/">this page</a> to install S60 5th Edition SDK. -</p> -<h3> <span class="mw-headline" id="Dump_S60_5th_Edition_ABI"> Dump S60 5th Edition ABI </span></h3> -<p>Create XML-descriptor for S60 5th Edition (S60-5th.xml): -</p> -<pre> <name> - S60 5th Edition - </name> - - <headers> - c:\Nokia\devices\S60_5th_Edition_SDK_v1.0\epoc32\include - </headers> - - <libs> - c:\Nokia\devices\S60_5th_Edition_SDK_v1.0\epoc32\release\armv5\lib\ - </libs> - - <tools> - c:\Program Files\CSL Arm Toolchain\bin\ - </tools> - - <cross_prefix> - arm-none-symbianelf - </cross_prefix> -</pre> -<p>Dump the S60 5th Edition ABI:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -dump-system S60-5th.xml  </code><br /><br /> -</p><p>The system ABI dump will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_dumps/S60 5th Edition/arm/ </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Setup_Symbian.5E3_SDK"> Setup Symbian^3 SDK </span></h3> -<p>Follow <a rel="nofollow" class="external text" href="https://www.developer.nokia.com/Resources/Tools_and_downloads/Other/Symbian_SDKs/">this page</a> to install Symbian^3 SDK. -</p> -<h3> <span class="mw-headline" id="Dump_Symbian.5E3_ABI"> Dump Symbian^3 ABI </span></h3> -<p>Create XML-descriptor for Symbian^3 (Symbian^3.xml): -</p> -<pre> <name> - Symbian^3 - </name> - - <headers> - c:\Nokia\devices\Nokia_Symbian3_SDK_v1.0\epoc32\include - </headers> - - <libs> - c:\Nokia\devices\Nokia_Symbian3_SDK_v1.0\epoc32\release\armv5\lib\ - </libs> - - <tools> - c:\Program Files\CodeSourcery\Sourcery G++ Lite\bin\ - </tools> - - <cross_prefix> - arm-none-symbianelf - </cross_prefix> -</pre> -<p>Dump the Symbian^3 ABI:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -dump-system Symbian^3.xml  </code><br /><br /> -</p><p>The system ABI dump will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_dumps/Symbian^3/arm/ </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Compare_ABI_Dumps_3"> Compare ABI Dumps </span></h3> -<p>Check S60 5th Edition and Symbian^3 for compatibility:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -cmp-systems -d1 "sys_dumps/S60 5th Edition/arm/" -d2 "sys_dumps/Symbian^3/arm/" </code><br /><br /> -</p><p>The compatibility report will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_compat_reports/S60 5th Edition_to_Symbian^3/arm/<a rel="nofollow" class="external text" href="http://upstream-tracker.org/compatibility/S60_5th_Edition_to_Symbian^3/arm/abi_compat_report.html">abi_compat_report.html</a> </code><br /><br /> -</p> -<!-- -NewPP limit report -Preprocessor node count: 114/1000000 -Post-expand include size: 0/2097152 bytes -Template argument size: 0/2097152 bytes -Expensive parser function count: 0/100 ---> - -<!-- Saved in parser cache with key rasispdb:pcache:idhash:2656-0!*!*!!en!*!* and timestamp 20140123073102 --> -</div></div></div></div></div></body></html>
\ No newline at end of file diff --git a/doc/SysCheck/Usage.html b/doc/SysCheck/Usage.html deleted file mode 100644 index 6e470e1..0000000 --- a/doc/SysCheck/Usage.html +++ /dev/null @@ -1,120 +0,0 @@ - -<!DOCTYPE html> -<html lang="en" dir="ltr" class="client-nojs"> -<head> -<title>Operating Systems Compatibility</title> -<meta charset="UTF-8" /> -<meta name="generator" content="MediaWiki 1.18.1" /> -<link rel="shortcut icon" href="/favicon.ico" /> -<link rel="search" type="application/opensearchdescription+xml" href="/opensearch_desc.php" title="ISP_RAS (en)" /> -<link rel="EditURI" type="application/rsd+xml" href="http://ispras.linuxbase.org/api.php?action=rsd" /> -<link rel="alternate" type="application/atom+xml" title="ISP_RAS Atom feed" href="/index.php?title=Special:RecentChanges&feed=atom" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=mediawiki.legacy.commonPrint%2Cshared%7Cskins.monobook&only=styles&skin=monobook&*" /> -<!--[if lt IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE50Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 5.5000]><link rel="stylesheet" href="/skins/monobook/IE55Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 6]><link rel="stylesheet" href="/skins/monobook/IE60Fixes.css?303" media="screen" /><![endif]--> -<!--[if IE 7]><link rel="stylesheet" href="/skins/monobook/IE70Fixes.css?303" media="screen" /><![endif]--><meta name="ResourceLoaderDynamicStyles" content="" /> -<link rel="stylesheet" href="/load.php?debug=false&lang=en&modules=site&only=styles&skin=monobook&*" /> -<style>a:lang(ar),a:lang(ckb),a:lang(fa),a:lang(kk-arab),a:lang(mzn),a:lang(ps),a:lang(ur){text-decoration:none}a.new,#quickbar a.new{color:#ba0000} - -/* cache key: rasispdb:resourceloader:filter:minify-css:4:c88e2bcd56513749bec09a7e29cb3ffa */ -</style> -<script src="/load.php?debug=false&lang=en&modules=startup&only=scripts&skin=monobook&*"></script> -<script>if(window.mw){ - mw.config.set({"wgCanonicalNamespace": "", "wgCanonicalSpecialPageName": false, "wgNamespaceNumber": 0, "wgPageName": "Operating_Systems_Compatibility", "wgTitle": "Operating Systems Compatibility", "wgCurRevisionId": 8057, "wgArticleId": 2655, "wgIsArticle": true, "wgAction": "view", "wgUserName": null, "wgUserGroups": ["*"], "wgCategories": ["ABI Compliance Checker"], "wgBreakFrames": false, "wgRestrictionEdit": [], "wgRestrictionMove": []}); -} -</script><script>if(window.mw){ - mw.loader.load(["mediawiki.page.startup"]); -} -</script> -</head> -<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-Operating_Systems_Compatibility action-view skin-monobook"> -<div id="globalWrapper"> -<div id="column-content"><div id="content"> - <a id="top"></a> - - <h1 id="firstHeading" class="firstHeading">Operating Systems Compatibility</h1> - <div id="bodyContent"> - <div id="siteSub"></div> - <div id="contentSub"></div> - - <!-- start content --> -<div lang="en" dir="ltr" class="mw-content-ltr"><p>This tutorial describes how to test operating systems for binary compatibility using the <a href="http://ispras.linuxbase.org/index.php/ABI_compliance_checker" title="ABI Compliance Checker">ABI Compliance Checker</a> tool. The tool is able to find all <b>C/C++</b> libraries and appropriate header files in system directories, create dump of system <b>ABI (API + compiler ABI)</b> including ABIs of all found libraries and then compare dumps created on different operating systems to produce the <a rel="nofollow" class="external text" href="http://upstream-tracker.org/compatibility/Maemo_4.1.2_to_Maemo_5.0/arm/abi_compat_report.html">HTML report</a> containing detailed comparison results. -</p> -<table id="toc" class="toc"><tr><td><div id="toctitle"><h2>Contents</h2></div> -<ul> -<li class="toclevel-1 tocsection-1"><a href="#Setting_Up_Environment"><span class="tocnumber">1</span> <span class="toctext">Setting Up Environment</span></a> -<ul> -<li class="toclevel-2 tocsection-2"><a href="#Apt-based_OS_.28Ubuntu.2C_Debian.2C_Maemo.29"><span class="tocnumber">1.1</span> <span class="toctext">Apt-based OS (Ubuntu, Debian, Maemo)</span></a></li> -<li class="toclevel-2 tocsection-3"><a href="#Zypper-based_OS_.28Fedora.2C_openSUSE.2C_MeeGo.29"><span class="tocnumber">1.2</span> <span class="toctext">Zypper-based OS (Fedora, openSUSE, MeeGo)</span></a></li> -<li class="toclevel-2 tocsection-4"><a href="#Urpmi-based_OS_.28Mandriva.2C_ROSA.2C_Mageia.29"><span class="tocnumber">1.3</span> <span class="toctext">Urpmi-based OS (Mandriva, ROSA, Mageia)</span></a></li> -<li class="toclevel-2 tocsection-5"><a href="#Apk-based_OS_.28Alpine_Linux.29"><span class="tocnumber">1.4</span> <span class="toctext">Apk-based OS (Alpine Linux)</span></a></li> -<li class="toclevel-2 tocsection-6"><a href="#Other_Systems_.28Symbian.2C_Windows.29"><span class="tocnumber">1.5</span> <span class="toctext">Other Systems (Symbian, Windows)</span></a></li> -</ul> -</li> -<li class="toclevel-1 tocsection-7"><a href="#Dumping_System_ABI"><span class="tocnumber">2</span> <span class="toctext">Dumping System ABI</span></a></li> -<li class="toclevel-1 tocsection-8"><a href="#Compare_ABI_Dumps"><span class="tocnumber">3</span> <span class="toctext">Compare ABI Dumps</span></a></li> -<li class="toclevel-1 tocsection-9"><a href="#Examples"><span class="tocnumber">4</span> <span class="toctext">Examples</span></a></li> -</ul> -</td></tr></table> -<h2> <span class="mw-headline" id="Setting_Up_Environment"> Setting Up Environment </span></h2> -<p>The first step is to setup development environment on target operating systems: -</p> -<ul><li> Install G++, Perl, Binutils, Ctags and File utility -</li><li> Install all "devel" packages or SDK. -</li></ul> -<h3> <span class="mw-headline" id="Apt-based_OS_.28Ubuntu.2C_Debian.2C_Maemo.29"> Apt-based OS (Ubuntu, Debian, Maemo) </span></h3> -<p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> apt-get update </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> apt-cache search "\-dev"|awk '{print $1;}'>install.txt </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> for i in `cat install.txt`;do sudo apt-get --force-yes -y install $i;done </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sudo apt-get install gcc perl binutils file ctags </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Zypper-based_OS_.28Fedora.2C_openSUSE.2C_MeeGo.29"> Zypper-based OS (Fedora, openSUSE, MeeGo) </span></h3> -<p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> zypper search -u dev|awk '{print $2;}'|grep "dev">install.txt </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> for i in `cat install.txt`;do sudo zypper -n install $i;done </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sudo zypper install gcc-c++ perl binutils file ctags </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Urpmi-based_OS_.28Mandriva.2C_ROSA.2C_Mageia.29"> Urpmi-based OS (Mandriva, ROSA, Mageia) </span></h3> -<p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> urpmq|grep "\-devel">install.txt </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> for i in `cat install.txt`;do sudo urpmi --auto --force $i;done </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sudo urpmi install gcc-c++ perl binutils file ctags </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Apk-based_OS_.28Alpine_Linux.29"> Apk-based OS (Alpine Linux) </span></h3> -<p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> apk update </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> apk search|grep "\-dev\-"|sed s/-dev-.*$/-dev/>install.txt </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> for i in `cat install.txt`;do sudo apk add $i;done </code><br /><br /> -</p><p>  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sudo apk add perl </code><br /><br /> -</p> -<h3> <span class="mw-headline" id="Other_Systems_.28Symbian.2C_Windows.29"> Other Systems (Symbian, Windows) </span></h3> -<p>Download and install the SDK. -</p> -<h2> <span class="mw-headline" id="Dumping_System_ABI"> Dumping System ABI </span></h2> -<p>The next step is to create an <a href="Descriptor.html" title="Operating System Descriptor">XML-descriptor</a> of target OS. -</p><p>Then enter to the target operating system and dump the system ABI using the following command:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -dump-system <i><<a href="Descriptor.html" title="Operating System Descriptor">descriptor.xml</a>></i> </code><br /><br /> -</p><p>If you want to analyze libraries from /usr/include and /usr/lib, then you may use the following short command instead:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -dump-system <i><name></i> -sysroot / </code><br /><br /> -</p><p>The system ABI dump will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_dumps/<i><name></i>/<arch>/ </code><br /><br /> -</p><p>Repeat this step for other operating system or other version of the same system if you want to check backward compatibility. -</p> -<h2> <span class="mw-headline" id="Compare_ABI_Dumps"> Compare ABI Dumps </span></h2> -<p>The last step is to compare ABI dumps of two operating systems:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> abi-compliance-checker -cmp-systems -d1 sys_dumps/<i><name1></i>/<i><arch></i> -d2 sys_dumps/<i><name2></i>/<i><arch></i> </code><br /><br /> -</p><p>The compatibility report will be generated to:<br /> -  <code style="border: dashed 1px gray; background-color: #f0f0f0;"> sys_compat_reports/<i><name1></i>_to_<i><name2></i>/<arch>/<a rel="nofollow" class="external text" href="http://upstream-tracker.org/compatibility/Maemo_4.1.2_to_Maemo_5.0/arm/abi_compat_report.html">abi_compat_report.html</a> </code><br /><br /> -</p> -<h2> <span class="mw-headline" id="Examples"> Examples </span></h2> -<p>See examples for <b>Maemo</b>, <b>MeeGo</b> and <b>Symbian</b> operating systems on <a href="Examples.html" title="Operating Systems Compatibility Examples">this page</a>. -<br /><br /> -</p> -<!-- -NewPP limit report -Preprocessor node count: 54/1000000 -Post-expand include size: 0/2097152 bytes -Template argument size: 0/2097152 bytes -Expensive parser function count: 0/100 ---> - -<!-- Saved in parser cache with key rasispdb:pcache:idhash:2655-0!*!0!!en!*!* and timestamp 20140122182516 --> -</div></div></div></div></div></body></html>
\ No newline at end of file diff --git a/doc/Xml-Descriptor.html b/doc/Xml-Descriptor.html new file mode 100644 index 0000000..8dd7da9 --- /dev/null +++ b/doc/Xml-Descriptor.html @@ -0,0 +1,602 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <meta name="description" content="XML Descriptor" /> + <title>XML Descriptor</title> + + <style type="text/css"> + body { + margin-top: 1.0em; + background-color: #deeef7; + font-family: Helvetica, Arial, FreeSans, san-serif; + color: #000000; + } + #container { + margin: 0 auto; + width: 700px; + } + h1 { font-size: 3.8em; color: #211108; margin-bottom: 3px;margin-top:0px;padding-top:0px;} + h1 .small { font-size: 0.4em; } + h1 a { text-decoration: none } + h2 { font-size: 1.5em; color: #211108; } + h3 { text-align: center; color: #211108; } + a { color: #211108; } + .description { font-size: 1.2em; margin-bottom: 30px; margin-top: 30px; font-style: italic;} + .download { float: right; } + pre {padding: 0px;margin: 0px;padding-left: 10px;word-wrap:break-word;white-space: pre-wrap;} + hr { border: 0; width: 80%; border-bottom: 1px solid #aaa} + .footer { text-align: center; padding-top:30px; font-style: italic; } + .code {border: dashed 1px gray; background-color: #f0f0f0;} + .listing {padding: 10px;border: 1px solid black;width: 70%;font-family:"DejaVu Sans Mono", "Monaco", "Courier New", monospace;font-size:14px;} + .summary {border:1px solid black;border-collapse:collapse;} + table.summary td, table.summary th {border:1px solid black;padding: 4px;} + .ext {color: Brown;font-weight: bold;} + </style> + +</head> + +<body> +<a href="https://github.com/lvc/abi-compliance-checker"><img style="position: absolute; top: 0; right: 0; border: 0;" src="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" /></a> + +<div id="container"> + +<h1>XML-Descriptor</h1> +<p/> +The library descriptor is a simple XML-file that specifies version number, paths to header files and shared libraries and optionally some other information. +<p/> + +<table class='summary'><tr><td> +<div>Table of Contents</div> +<ul> +<li><a href="#Primary">Primary Sections</a></li> +<li><a href="#Optional">Optional Sections</a></li> +<li><a href="#Examples">Examples</a></li> +</ul> +</td></tr></table> + +<a name="Primary"></a> +<h2>Primary Sections</h2> +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + /* Version of the library */ +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /* The list of paths to header files or/and + directories with header files, one per line */ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /* The list of paths to shared libraries or/and + directories with shared libraries, one per line */ +<span style='color:Green;'></libs></span> +</pre> +</div> +<p/> + +<a name="Optional"></a> +<h2>Optional Sections</h2> +<div class='listing'> +<pre> +<span style='color:Green;'><include_paths></span> + /* The list of paths to be searched for header files + needed for compiling of library headers, one per + line. NOTE: If you define this section then the tool + will not automatically detect include paths */ +<span style='color:Green;'></include_paths></span> + +<span style='color:Green;'><add_include_paths></span> + /* The list of include paths that should be added + to the automatically detected include paths, one per + line */ +<span style='color:Green;'></add_include_paths></span> + +<span style='color:Green;'><skip_include_paths></span> + /* The list of include paths that will be removed from + the list of automatically generated include paths, one + per line */ +<span style='color:Green;'></skip_include_paths></span> + +<span style='color:Green;'><gcc_options></span> + /* Additional GCC options, one per line */ +<span style='color:Green;'></gcc_options></span> + +<span style='color:Green;'><include_preamble></span> + /* The list of header files that should be included + before other headers, one per line. For example, it + is a tree.h for libxml2 and ft2build.h for freetype2 + library */ +<span style='color:Green;'></include_preamble></span> + +<span style='color:Green;'><defines></span> + /* Add defines at the headers compiling stage, one per + line: + #define A B + #define C D */ +<span style='color:Green;'></defines></span> + +<span style='color:Green;'><add_namespaces></span> + /* The list of namespaces that should be added to the + alanysis if the tool cannot find them automatically, + one per line */ +<span style='color:Green;'></add_namespaces></span> + +<span style='color:Green;'><skip_types></span> + /* The list of data types, that + should not be checked, one per line */ +<span style='color:Green;'></skip_types></span> + +<span style='color:Green;'><skip_symbols></span> + /* The list of functions (mangled/symbol names in C++), + that should not be checked, one per line */ +<span style='color:Green;'></skip_symbols></span> + +<span style='color:Green;'><skip_namespaces></span> + /* The list of C++ namespaces, that + should not be checked, one per line */ +<span style='color:Green;'></skip_namespaces></span> + +<span style='color:Green;'><skip_constants></span> + /* The list of constants that should not be checked, + one name per line */ +<span style='color:Green;'></skip_constants></span> + +<span style='color:Green;'><skip_headers></span> + /* The list of header files and/or directories + with header files that should not be checked, one per + line */ +<span style='color:Green;'></skip_headers></span> + +<span style='color:Green;'><skip_libs></span> + /* The list of shared libraries and/or directories + with shared libraries that should not be checked, one + per line */ +<span style='color:Green;'></skip_libs></span> + +<span style='color:Green;'><skip_including></span> + /* The list of header files, that cannot be included + directly (or non-self compiled ones), one per line */ +<span style='color:Green;'></skip_including></span> + +<span style='color:Green;'><search_headers></span> + /* List of directories to be searched + for header files to automatically + generate include paths, one per line */ +<span style='color:Green;'></search_headers></span> + +<span style='color:Green;'><search_libs></span> + /* List of directories to be searched + for shared librariess to resolve + dependencies, one per line */ +<span style='color:Green;'></search_libs></span> + +<span style='color:Green;'><tools></span> + /* List of directories with tools used + for analysis (GCC toolchain), one per line */ +<span style='color:Green;'></tools></span> + +<span style='color:Green;'><cross_prefix></span> + /* GCC toolchain prefix. + Examples: + arm-linux-gnueabi + arm-none-symbianelf */ +<span style='color:Green;'></cross_prefix></span> +</pre> +</div> +<p/> + +<a name="Examples"></a> +<h2>Examples</h2> + +libssh: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 0.3.4 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/libssh/0.3.4/include/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/libssh/0.3.4/lib/ +<span style='color:Green;'></libs></span> +</pre> +</div> +<p/> + +atk: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 1.28.0 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/atk-1.28.0/include/atk-1.0/atk/atk.h +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/atk-1.28.0/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_paths></span> + /usr/include/glib-2.0/ + /usr/lib/glib-2.0/include/ +<span style='color:Green;'></include_paths></span> +</pre> +</div> +<p/> + +libxml2: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 2.7.6 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/libxml2-2.7.6/include/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/libxml2-2.7.6/lib/libxml2.so.2.7.6 +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_preamble></span> + tree.h +<span style='color:Green;'></include_preamble></span> +</pre> +</div> +<p/> + +libX11: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 1.3.2 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/libX11-1.3.2/include/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/libX11-1.3.2/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_preamble></span> + Xlib.h +<span style='color:Green;'></include_preamble></span> +</pre> +</div> +<p/> + +BlackBerry 10 Native SDK: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 10 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /home/RIM/bbndk/target_10_0_9_1673/qnx6/usr/include/bb/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><search_headers></span> + /home/RIM/bbndk/target_10_0_9_1673/qnx6/usr/include/ +<span style='color:Green;'></search_headers></span> + +<span style='color:Green;'><libs></span> + /home/RIM/bbndk/target_10_0_9_1673/qnx6/x86/usr/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><tools></span> + /home/RIM/bbndk/host_10_0_9_404/linux/x86/usr/bin/ +<span style='color:Green;'></tools></span> + +<span style='color:Green;'><cross_prefix></span> + i486-pc-nto-qnx8.0.0 +<span style='color:Green;'></cross_prefix></span> +</pre> +</div> +<p/> + +libQt5Core: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 5.5.0 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/Qt-5.5.0/include/QtCore +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/Qt-5.5.0/lib/libQt5Core.so.5.5.0 +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_paths></span> + /usr/local/Qt-5.5.0/include/ +<span style='color:Green;'></include_paths></span> + +<span style='color:Green;'><skip_headers></span> + /private/ + qt_windows.h + qatomic_* + *_impl.h +<span style='color:Green;'></skip_headers></span> + +<span style='color:Green;'><gcc_options></span> + -fvisibility=hidden + -fvisibility-inlines-hidden + -fPIC + -Wall + -W + -D_REENTRANT + -DQT_NO_CAST_FROM_ASCII + -DQT_NO_CAST_TO_ASCII + -DQT_NO_STL + -DQT_SHARED +<span style='color:Green;'></gcc_options></span> +</pre> +</div> +<p/> + +libxslt: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 1.1.22 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/libxslt-1.1.22/include/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/libxslt-1.1.22/lib/libxslt.so + /usr/local/libxslt-1.1.22/lib/libexslt.so +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_paths></span> + /usr/include/libxml2/ +<span style='color:Green;'></include_paths></span> + +<span style='color:Green;'><include_preamble></span> + xsltInternals.h +<span style='color:Green;'></include_preamble></span> +</pre> +</div> +<p/> + +libxml++: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 2.26.1 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/libxml++-2.26.1/include/ + /usr/local/libxml++-2.26.1/lib/libxml++-2.6/include/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/libxml++-2.26.1/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_paths></span> + /usr/include/glib-2.0/ + /usr/lib/glib-2.0/include/ + /usr/include/glibmm-2.4/ + /usr/lib/glibmm-2.4/include/ +<span style='color:Green;'></include_paths></span> +</pre> +</div> +<p/> + +pango: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 1.26.0 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/pango-1.26.0/include/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/pango-1.26.0/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_paths></span> + /usr/include/glib-2.0/ + /usr/lib/glib-2.0/include/ + /usr/include/cairo/ + /usr/include/freetype2/ + /usr/include/X11/ +<span style='color:Green;'></include_paths></span> + +<span style='color:Green;'><include_preamble></span> + pango.h +<span style='color:Green;'></include_preamble></span> +</pre> +</div> +<p/> + +gtk+: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 2.18.4 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/gtk+-2.18.4/include/gtk-2.0/gdk/gdk.h + /usr/local/gtk+-2.18.4/include/gtk-2.0/gtk/gtk.h + /usr/local/gtk+-2.18.4/include/gail-1.0/ + /usr/local/gtk+-2.18.4/include/gtk-unix-print-2.0/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/gtk+-2.18.4/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_paths></span> + /usr/include/atk-1.0/ + /usr/include/glib-2.0/ + /usr/lib/glib-2.0/include/ + /usr/include/cairo/ + /usr/include/pango-1.0/ +<span style='color:Green;'></include_paths></span> +</pre> +</div> +<p/> + +glib: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 2.22.2 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/glib-2.22.2/include/glib-2.0/glib.h + /usr/local/glib-2.22.2/include/glib-2.0/glib-object.h + /usr/local/glib-2.22.2/include/glib-2.0/gmodule.h +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/glib-2.22.2/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_paths></span> + /usr/local/glib-2.22.2/lib/glib-2.0/include/ +<span style='color:Green;'></include_paths></span> +</pre> +</div> +<p/> + +libsoup: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 2.28.0 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/libsoup-2.28.0/include/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/libsoup-2.28.0/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_paths></span> + /usr/include/glib-2.0/ + /usr/lib/glib-2.0/include/ +<span style='color:Green;'></include_paths></span> +</pre> +</div> +<p/> + +allegro: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 4.9.9.1 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/include/allegro5/allegro.h +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/lib/liballegro-4.9.9.so +<span style='color:Green;'></libs></span> +</pre> +</div> +<p/> + +mathgl: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 1.9.0.1 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/mathgl-1.9.0.1/include/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/mathgl-1.9.0.1/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_paths></span> + /usr/local/gsl-1.9/include/ +<span style='color:Green;'></include_paths></span> +</pre> +</div> +<p/> + +gsl: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 1.9 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/gsl-1.9/include/ +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/gsl-1.9/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_preamble></span> + stdlib.h +<span style='color:Green;'></include_preamble></span> +</pre> +</div> +<p/> + +libjpeg: +<div class='listing'> +<pre> +<span style='color:Green;'><version></span> + 7 +<span style='color:Green;'></version></span> + +<span style='color:Green;'><headers></span> + /usr/local/libjpeg-7/include/jpeglib.h +<span style='color:Green;'></headers></span> + +<span style='color:Green;'><libs></span> + /usr/local/libjpeg-7/lib/ +<span style='color:Green;'></libs></span> + +<span style='color:Green;'><include_preamble></span> + stdio.h +<span style='color:Green;'></include_preamble></span> +</pre> +</div> +<p/> + +<div class="footer"> + get the source code on GitHub : <a href="https://github.com/lvc/abi-compliance-checker">lvc/abi-compliance-checker</a> +</div> + +<br/> +<br/> + +</div> +</body> +</html> diff --git a/doc/index.html b/doc/index.html new file mode 100644 index 0000000..6ffa6dd --- /dev/null +++ b/doc/index.html @@ -0,0 +1,708 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + <meta name="keywords" content="C, C++, ABI, API, compatibility, checker" /> + <meta name="description" content="A tool for checking backward API/ABI compatibility of a C/C++ library" /> + <title>ABI Compliance Checker</title> + + <style type="text/css"> + body { + margin-top: 1.0em; + background-color: #deeef7; + font-family: Helvetica, Arial, FreeSans, san-serif; + color: #000000; + } + #container { + margin: 0 auto; + width: 700px; + } + h1 { font-size: 3.8em; color: #211108; margin-bottom: 3px;margin-top:0px;padding-top:0px;} + h1 .small { font-size: 0.4em; } + h1 a { text-decoration: none } + h2 { font-size: 1.5em; color: #211108; } + h3 { text-align: center; color: #211108; } + a { color: #211108; } + .description { font-size: 1.2em; margin-bottom: 30px; margin-top: 30px; font-style: italic;} + .download { float: right; } + pre {padding: 0px;margin: 0px;padding-left: 10px;word-wrap:break-word;white-space: pre-wrap;} + hr { border: 0; width: 80%; border-bottom: 1px solid #aaa} + .footer { text-align:center; padding-top:30px; font-style: italic; } + .code {border: dashed 1px gray; background-color: #f0f0f0;} + .listing {padding: 10px;border: 1px solid black;width: 70%;font-family:"DejaVu Sans Mono", "Monaco", "Courier New", monospace;font-size:14px;} + .summary {border:1px solid black;border-collapse:collapse;} + table.summary td, table.summary th {border:1px solid black;padding:2px;} + </style> + +</head> + +<body> + <a href="https://github.com/lvc/abi-compliance-checker"><img style="position: absolute; top: 0; right: 0; border: 0;" src="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" /></a> + + <div id="container"> + + <div class="download"> + <a href="https://github.com/lvc/abi-compliance-checker/zipball/master"> + <img style="border: 0;" width="90" src="https://github.com/images/modules/download/zip.png" alt="" /></a> + <a href="https://github.com/lvc/abi-compliance-checker/tarball/master"> + <img style="border: 0;" width="90" src="https://github.com/images/modules/download/tar.png" alt="" /></a> + </div> + + <h1>ABI Compliance Checker</h1> + + <div class="description"> + A tool for checking backward API/ABI compatibility of a C/C++ library + </div> + + <p/> + ABI Compliance Checker (ABICC) is a tool for checking backward binary and source-level compatibility of a C/C++ library. The tool checks header files and shared libraries of old and new versions and analyzes changes in API and ABI (ABI=API+compiler ABI) that may break binary and/or source compatibility: changes in calling stack, v-table changes, removed symbols, renamed fields, etc. + + <p/> + Binary incompatibility may result in crashing or incorrect behavior of applications built with an old version of a library if they run on a new one. Source incompatibility may result in recompilation errors with a new library version. 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. + +<table class='summary'><tr><td> +<div>Table of Contents</div> +<ul> +<li><a href="#Downloads">Downloads</a></li> +<li><a href="#License">License</a></li> +<li><a href="#Supported_Platforms">Supported Platforms</a></li> +<li><a href="#Dependencies">Dependencies</a></li> +<li><a href="#Installation">Installation</a></li> +<li><a href="#Usage">Usage</a></li> +<li><a href="#Examples">Examples</a></li> +<li><a href="#BinaryProblems">Detectable Binary-Compatibility Problems</a></li> +<li><a href="#SourceProblems">Detectable Source-Compatibility Problems</a></li> +<li><a href="#Dump">Create ABI Dumps</a></li> +<li><a href="#ABI_Dumper">Usage with ABI Dumper</a></li> +<li><a href="#Report">Report Format</a></li> +<li><a href="#Verdict">Verdict on Compatibility</a></li> +<li><a href="#Error">Error Codes</a></li> +<li><a href="#FAQ">FAQ</a></li> +<li><a href="#Similar">Similar Tools</a></li> +<li><a href="#Tutorial">Tutorial</a></li> +<li><a href="#Bugs">Bugs</a></li> +<li><a href="#Maintainers">Maintainers</a></li> +<li><a href="#ChangeLog">Changes</a></li> +<li><a href="#Articles">Articles</a></li> +</ul> +</td></tr></table> + +<a name="Downloads"></a> +<h2>Downloads</h2> +<p>All releases can be downloaded from <a href="https://github.com/lvc/abi-compliance-checker/">this page</a>.</p> + +<p>Latest release: <a href="https://github.com/lvc/abi-compliance-checker/archive/1.99.9.tar.gz">abi-compliance-checker-1.99.9.tar.gz</a></p> + +<p>Read-only access to the latest development version:</p> + +<code class='code'> git clone git://github.com/lvc/abi-compliance-checker </code> + +<a name="License"></a> +<h2>License</h2> +<p>This program is free software. You may use, redistribute and/or modify it under the terms of the <a href="http://www.gnu.org/licenses/">GNU GPL</a> or <a href="http://www.gnu.org/licenses/">GNU LGPL</a></p> + +<a name="Supported_Platforms"></a> +<h2>Supported Platforms</h2> +GNU/Linux, FreeBSD, Mac OS X, MS Windows. + +<a name="Dependencies"></a> +<h2>Dependencies</h2> +<ul> +<li> + <a href="http://gcc.gnu.org/">G++</a> (3.0-4.7, 4.8.3, 4.9 or newer) +</li> +<li> + <a href="http://www.gnu.org/software/binutils/">GNU Binutils</a> (readelf, c++filt, objdump) +</li> +<li> + <a href="http://www.perl.org/">Perl 5</a> (5.8 or newer) +</li> +<li> + <a href="http://ctags.sourceforge.net/">Ctags</a> (5.8 or newer) +</li> +</ul> + +WARNING: if you are using ccache program (i.e. gcc points to /usr/lib/ccache/gcc) then it should be newer than 3.1.2 or disabled. +<p/> +On Mac OS X the tool also requires Xcode (g++, c++filt, nm and otool). +<p/> +On MS Windows the tool also requires MinGW, MS Visual C++ (dumpbin, undname, cl), Active Perl 5, adding of tool locations to the PATH and execution of vsvars32.bat script (C:\Microsoft Visual Studio 9.0\Common7\Tools\). + +<a name="Installation"></a> +<h2>Installation</h2> +<p>The tool is <b>ready-to-use</b> after extracting the archive.</p> + +<p>You can also use a Makefile to install the tool into the system:</p> +<code class='code'> sudo make install prefix=PREFIX [/usr, /usr/local] </code> +<p>This command will install the <code>abi-compliance-checker</code> program into the <code>PREFIX/bin</code> system directory and private modules into the <code>PREFIX/share</code>.</p> + +<a name="Usage"></a> +<h2>Usage</h2> + +For using the tool, you should provide the <a href='Xml-Descriptor.html'>XML descriptors</a> for two library versions: <code>v1.xml</code> and <code>v2.xml</code> files. Library descriptor is a simple XML-file that specifies version number, paths to header files and shared libraries and other optional information. An example of the descriptor is the following (<code>0.3.4.xml</code>): +<p/> +<div class='listing'> +<pre> +<span style='color:Green'><version></span> + 0.3.4 +<span style='color:Green'></version></span> + +<span style='color:Green'><headers></span> + /usr/local/libssh/0.3.4/include/ +<span style='color:Green'></headers></span> + +<span style='color:Green'><libs></span> + /usr/local/libssh/0.3.4/lib/ +<span style='color:Green'></libs></span> +</pre> +</div> +<p/> + +Command to compare two versions of a library: +<p/> +<code class='code'>abi-compliance-checker -lib NAME -old V1.xml -new V2.xml</code> +<p/> +The compatibility report will be generated to: +<p/> +<code class='code'>compat_reports/NAME/V1_to_V2/compat_report.html</code> +<p/> + +<a name="Examples"></a> +<h2>Examples</h2> +<table class='summary'> +<tr><th>Library</th><th>Versions</th><th>Report</th></tr> +<tr> +<td>NetCDF</td> +<td>4.0.1 to 4.1.1</td> +<td><a href='http://upstream-tracker.org/compat_reports/netcdf/4.0.1_to_4.1.1/compat_report.html'>report</a></td> +</tr> +<tr> +<td>MySQL++</td> +<td>3.0.9 to 3.1.0</td> +<td><a href='http://upstream-tracker.org/compat_reports/mysql++/3.0.9_to_3.1.0/abi_compat_report.html'>report</a></td> +</tr> +<tr> +<td>libssh</td> +<td>0.3.4 to 0.4.0</td> +<td><a href='http://upstream-tracker.org/compat_reports/libssh/0.3.4_to_0.4.0/abi_compat_report.html'>report</a></td> +</tr> +</table> + +<a name="BinaryProblems"></a> +<h2>Detectable Binary Compatibility Problems</h2> +<ul> +<li> + +<b>Problems with Data Types</b> +<ul> + <li> + Structures and Classes + <ul> + <li> + added/removed fields (change of a memory layout) + </li> + <li> + change of size + </li> + <li> + changed order of fields + </li> + <li> + change of a field type + </li> + <li> + changes in fields (recursive analysis) + </li> + </ul> + </li> + <li> + Classes + <ul> + <li> + added/removed virtual functions (change of a v-table layout) + </li> + <li> + change of virtual function position + </li> + <li> + overridden virtual functions + </li> + <li> + added/removed base classes + </li> + <li> + changes in base classes (recursive analysis) + </li> + </ul> + </li> + <li> + Unions + <ul> + <li> + added/removed fields + </li> + <li> + change of size + </li> + <li> + change of a field type + </li> + <li> + changes in fields (recursive analysis) + </li> + </ul> + </li> + <li> + Enumerations + <ul> + <li> + change of a member value + </li> + <li> + removed/renamed members + + <br/> + <br/> + </li> + </ul> + </li> +</ul> + +</li> +<li> + +<b>Problems with Symbols</b> +<ul> + <li> + removed symbols (functions or global data) + </li> + <li> + added/removed parameters + </li> + <li> + change of a parameter/return value type + </li> + <li> + change of default parameter value + </li> + <li> + renamed parameters + </li> + <li> + incorrect version change + </li> + <li> + changed attributes (const, volatile, static, etc.) + + <br/> + <br/> + </li> +</ul> + +</li> +<li> +<b>Problems with Constants (#defines)</b> +<ul> +<li> + changed value +</li> +</ul> + +</li> +</ul> +<p/> + +See <a href='http://techbase.kde.org/Policies/Binary_Compatibility_Issues_With_C++'>"Binary Compatibility Issues With C++"</a> article from KDE TechBase for more info. + +<a name="SourceProblems"></a> +<h2>Detectable Source Compatibility Problems</h2> +<ul> +<li> + +<b>Problems with Data Types</b> +<ul> + <li> + Structures, Classes and Unions + <ul> + <li> + removed/renamed fields + </li> + <li> + change of a field type + </li> + <li> + changes in fields (recursive analysis) + </li> + </ul> + </li> + <li> + Classes + <ul> + <li> + added/removed base classes + </li> + <li> + change access level of a field or method + </li> + <li> + added pure virtual methods + </li> + </ul> + </li> + <li> + Enumerations + <ul> + <li> + removed/renamed members + + <br/> + <br/> + </li> + </ul> + </li> +</ul> +</li> + +<li> + +<b>Problems with Symbols</b> +<ul> + <li> + removed symbols (functions or global data) + </li> + <li> + added/removed parameters + </li> + <li> + change of a parameter type + </li> + <li> + removed default value of parameter + </li> + <li> + change of return value type + </li> + <li> + changed attributes (const, static, etc.) + </li> +</ul> + +</li> + +</ul> + +<a name="Dump"></a> +<h2>Create ABI Dumps</h2> +The library ABI is a representation of the library API at the binary level. The ABI dump is a dump of the model of the ABI used in the tool. +<p/> +The ABI dump consists of: + +<ul> + +<li> + <b>Types Information</b> + <ul> + <li> + Attributes (name, size, header, access, base types, etc.) + </li> + <li> + Fields (name, type, size, position, alignment, access, specifiers, etc.) + </li> + <li> + V-table structure (offsets, entries) + </li> + <li> + Etc. + </li> + </ul> +</li> + +<li> + <b>Symbols Information</b> + <ul> + <li> + Attributes (name, mangled name, header, access, specifiers, etc.) + </li> + <li> + Parameters (name, type, position, alignment, etc.) + </li> + <li> + Etc. + </li> + </ul> +</li> + +<li> + Etc. +</li> + +</ul> + +The ABI dump can be used to create a snapshot of a library ABI in the particular environment and then compare it with any other state of the ABI changed due to changes in the environment (compiler version, external libraries, etc.) or changes in the library API (header files). + +<p/> +The typical case is the comparing of two versions of the same library that require incompatible states of the environment (i.e. these versions cannot be installed simultaneously). In this case one can create a dump for one version of the library and then switch the environment and create ABI dump for other version of the library. Two ABI dumps can be compared by the tool to create the API compatibility report. +<p/> +To create an ABI dump use <code>-dump</code> option: +<p/> +<code class='code'>abi-compliance-checker -lib NAME -dump VER.xml</code> +<p/> +The ABI dump will be generated to: +<p/> +<code class='code'>abi_dumps/NAME/NAME_VER.abi.tar.gz</code> +<p/> +To compare ABI dumps pass them as the descriptors: +<p/> +<code class='code'>abi-compliance-checker -lib NAME -old V1.abi.tar.gz -new V2.abi.tar.gz</code> + +<a name="ABI_Dumper"></a> +<h2>Usage with ABI Dumper</h2> +The analyzed library should be compiled with "-g -Og" GCC options to contain DWARF debug info. +<p/> +Create ABI dumps for both library versions using the <a href='https://github.com/lvc/abi-dumper'>ABI Dumper</a> tool: +<p/> +<code class='code'>abi-dumper OLD.so -o ABI-0.dump -lver 0</code> +<p/> +<code class='code'>abi-dumper NEW.so -o ABI-1.dump -lver 1</code> +<p/> +Compare ABI dumps: +<code class='code'>abi-compliance-checker -l NAME -old ABI-0.dump -new ABI-1.dump</code> + +<a name="Report"></a> +<h2>Report Format</h2> +The tool supports two formats of a compatibility report: HTML (default) and XML. To generate XML report you should specify <code>-xml</code> additional option. +<p/> +The report consists of: + +<ul> + <li> + <b>Test Info</b> - The library name and compared version numbers. Environment info: GCC version and CPU type. + </li> + <li> + <b>Test Results</b> - Verdict on compatibility. Number of header files, shared libraries, symbols and data types checked by the tool. + </li> + <li> + <b>Problem Summary</b> - Classification of compatibility problems. + </li> + <li> + <b>Added Symbols</b> - The list of added symbols. + </li> + <li> + <b>Removed Symbols</b> - The list of removed symbols. + </li> + <li> + <b>Problems with Data Types</b> - The list of compatibility problems caused by changes in data types (divided by the severity level: High, Medium and Low). List of affected symbols. + </li> + <li> + <b>Problems with Symbols</b> - The list of compatibility problems caused by changes in symbol parameters or attributes (divided by the severity level). + </li> + <li> + <b>Problems with Constants</b> - The list of changed constants (#defines). + </li> + <li> + <b>Other Changes in Data Types</b> - The list of compatible changes in data types. + </li> + <li> + <b>Other Changes in Symbols</b> - The list of compatible changes in symbols. + </li> +</ul> + +<a name="Verdict"></a> +<h2>Verdict on Compatibility</h2> +If the tool detects problems with high or medium level of severity or at least one removed symbol then the compatibility verdict is <b>incompatible</b> (otherwise <b>compatible</b>). Low-severity problems can be considered as <b>warnings</b> and don't affect the compatibility verdict unless the <code>-strict</code> option is specified. + +<a name="Error"></a> +<h2>Error Codes</h2> +<table class='summary'> +<tr><th>Code</th><th>Meaning</th></tr> +<tr><td>0</td><td>Compatible. The tool has run without any errors.</td></tr> +<tr><td>1</td><td>Incompatible. The tool has run without any errors.</td></tr> +<tr><td>2</td><td>Common error code (undifferentiated).</td></tr> +<tr><td>3</td><td>A system command is not found.</td></tr> +<tr><td>4</td><td>Cannot access input files.</td></tr> +<tr><td>5</td><td>Cannot compile header files.</td></tr> +<tr><td>6</td><td>Headers have been compiled with minor errors.</td></tr> +<tr><td>7</td><td>Invalid input ABI dump.</td></tr> +<tr><td>8</td><td>Unsupported version of input ABI dump.</td></tr> +<tr><td>9</td><td>Cannot find a module.</td></tr> +<tr><td>10</td><td>Empty intersection between headers and shared objects.</td></tr> +<tr><td>11</td><td>Empty set of symbols in headers.</td></tr> +</table> + +<a name="FAQ"></a> +<h2>FAQ</h2> +<ul> + <li> + <b>What is an ABI and how does it differ from an API?</b> + <p/> + An Application Binary Interface (ABI) is the set of supported run-time interfaces provided by a software component or set of components for applications to use, whereas an Application Programming Interface (API) is the set of build-time interfaces. The ABI may be defined by the formula: ABI = API + compiler ABI. + </li> + <li> + <b>Why does this tool need both shared libraries and header files to check ABI compliance?</b> + <p/> + Without header files it is impossible to determine public symbols in ABI and data type definitions. Without shared libraries it is impossible to determine exported symbols in the ABI of the target library and also impossible to detect added/removed symbols. + </li> +</ul> + +<a name="Similar"></a> +<h2>Similar Tools </h2> +<ul> + <li> + <b>icheck</b> - C interface ABI/API checker. + </li> + <li> + <b>BCS</b> - The Symbian binary compatibility suite. + </li> + <li> + <b>shlib-compat</b> - ABI compatibility checker that uses DWARF debug info. + </li> + <li> + <b>qbic</b> - A tool to check for binary incompatibilities in Qt4 Toolkit. + </li> + <li> + <b>libabigail</b> - A C++ library for ABI analysis. + </li> + <li> + <b>chkshlib, cmpdylib, cmpshlib</b> - Tools to compare binary symbols. + </li> +</ul> + +<a name="Tutorial"></a> +<h2>Tutorial</h2> +An excellent tutorial <a href='http://blog.famillecollet.com/post/2010/06/20/ABI-%3A-stability-check'>"ABI: stability check"</a> is available at Les RPM de Remi Blog. See also <a href='http://sourceware.org/glibc/wiki/Testing/ABI_checker'>ABI compliance checker Notes</a> at glibc wiki. +<p/> + +<a name="Bugs"></a> +<h2>Bugs</h2> +Please post bug reports, feature requests and questions to the <a href="https://github.com/lvc/abi-compliance-checker/issues">issue tracker</a>. +<p/> + +<a name="Maintainers"></a> +<h2>Maintainers</h2> +The tool is developed by <a href="http://www.linkedin.com/pub/andrey-ponomarenko/67/366/818">Andrey Ponomarenko</a>. + +<a name="ChangeLog"></a> +<h2>Changes</h2> +You can find changelog <a href='Changelog.html'>here</a>. + +<a name="Articles"></a> +<h2>Articles</h2> + +<ul> + <li> + <a href='http://techbase.kde.org/Policies/Binary_Compatibility_Issues_With_C++'>"Binary Compatibility Issues With C++"</a>, KDE TechBase + </li> + <li> + <a href='http://techbase.kde.org/Policies/Binary_Compatibility_Examples'>"Binary Compatibility Examples"</a>, KDE TechBase + </li> + <li> + <a href='http://doi.ieeecomputersociety.org/10.1109/VALID.2010.27'>"Automated Verification of Shared Libraries for Backward Binary Compatibility"</a>, A. Ponomarenko and V. Rubanov, VALID 2010 + </li> + <li> + <a href='http://www.springerlink.com/content/905067689q7n0166/'>"Backward compatibility of software interfaces: Steps towards automatic verification"</a>, A. Ponomarenko and V. Rubanov, Programming and Computer Software 2012 + </li> + <li> + <a href='http://refspecs.linux-foundation.org/cxxabi-1.83.html'>"Itanium C++ ABI"</a>, linux-foundation.org + </li> + <li> + <a href='http://www.ros.org/reps/rep-0009.html'>"ABI Compatibility"</a>, Josh Faust + </li> + <li> + <a href='http://blog.famillecollet.com/post/2010/06/20/ABI-%3A-stability-check'>"ABI : stability check"</a>, Les RPM de Remi - Blog + </li> + <li> + <a href='http://www.agner.org/optimize/calling_conventions.pdf'>"Calling conventions for different C++ compilers and operating systems"</a>, Agner Fog + </li> + <li> + <a href='http://www.angelcode.com/dev/callconv/callconv.html'>"Calling conventions on the x86 platform"</a>, Andreas Jonsson + </li> + <li> + <a href='http://blog.qt.digia.com/blog/2009/08/12/some-thoughts-on-binary-compatibility/'>"Some thoughts on binary compatibility"</a>, Thiago Macieira + </li> + <li> + <a href='http://syrcose.ispras.ru/2009/files/02_paper.pdf'>"Binary Compatibility of C++ shared libraries on GNU/Linux"</a>, Pavel Shved, Denis Silakov + </li> + <li> + <a href='http://www.usenix.org/publications/library/proceedings/als00/2000papers/papers/full_papers/browndavid/browndavid_html/'>"Library Interface Versioning in Solaris and Linux"</a>, David J. Brown and Karl Runge + </li> + <li> + <a href='http://h21007.www2.hp.com/portal/download/files/prot/files/STK/pdfs/V_4version.pdf'>"Steps to Version Your Shared Library"</a>, hp.com + </li> + <li> + <a href='http://chadaustin.me/cppinterface.html'>"Binary-compatible C++ Interfaces"</a>, Chad Austin + </li> + <li> + <a href='http://gcc.gnu.org/onlinedocs/libstdc++/manual/abi.html'>"ABI Policy and Guidelines"</a>, gnu.org + </li> + <li> + <a href='http://gcc.gnu.org/onlinedocs/gcc/Compatibility.html'>"Binary Compatibility"</a>, gnu.org + </li> + <li> + <a href='http://www.oracle.com/technetwork/articles/servers-storage-dev/stablecplusplusabi-333927.html'>"Stability of the C++ ABI: Evolution of a Programing Language"</a>, Stephen Clamage + </li> + <li> + <a href='http://www.netfort.gr.jp/~dancer/column/libpkg-guide/libpkg-guide.html#binarycompat'>"When binary compatibility breaks"</a>, Debian Library Packaging guide + </li> + <li> + <a href='http://techbase.kde.org/Policies/Library_Code_Policy'>"Library Code Policy"</a>, KDE TechBase + </li> + <li> + <a href='http://people.redhat.com/drepper/dsohowto.pdf'>"How To Write Shared Libraries"</a>, Ulrich Drepper + </li> + <li> + <a href='http://tldp.org/HOWTO/Program-Library-HOWTO/'>"Program Library HOWTO"</a>, linux.org + </li> + <li> + <a href='http://plan99.net/~mike/writing-shared-libraries.html'>"Writing shared libraries"</a>, Mike Hearn + </li> + <li> + <a href='http://www.ayukov.com/essays/linuxdll.html'>"Shared libraries in Linux: growing pains or fundamental problem?"</a>, Sergey Ayukov + </li> + <li> + <a href='http://c2.com/cgi/wiki?FragileBinaryInterfaceProblem'>"Fragile Binary Interface Problem"</a>, Steven Newton + </li> + <li> + <a href='http://www.oocities.org/mrshrap/linker.html'>"The amazing world of library incompatibility"</a>, oocities.org + </li> + <li> + <a href='http://www.elpauer.org/?p=230'>"ABI compatibility in C++"</a>, elpauer.org + </li> + <li> + <a href='http://blogs.gentoo.org/mgorny/2012/08/20/the-impact-of-cxx-templates-on-library-abi/'>"The impact of C++ templates on library ABI"</a>, Michał Górny + </li> + <li> + <a href='http://sourceware.org/glibc/wiki/Testing/ABI_checker'>"ABI compliance checker Notes"</a>, sourceware.org + </li> + <li> + <a href='http://developer.symbian.org/wiki/index.php/Preserving_Compatibility'>"Preserving Compatibility"</a>, symbian.org + </li> + <li> + <a href='http://www.macieira.org/blog/2012/01/architectures-and-abis-detailed/'>"Architectures and ABIs detailed"</a>, Thiago Macieira's blog + </li> + <li> + <a href='http://accu.org/index.php/journals/1718'>"Interface Versioning in C++"</a>, ACCU + </li> + <li> + Processor ABI standards: <a href='http://refspecs.linuxbase.org/elf/abi386-4.pdf'>Intel386</a>, <a href='http://www.x86-64.org/documentation/abi.pdf'>AMD64</a>, <a href='http://infocenter.arm.com/help/topic/com.arm.doc.ihi0042d/IHI0042D_aapcs.pdf'>ARM</a>, <a href='http://refspecs.linuxbase.org/elf/elfspec_ppc.pdf'>PowerPC</a>, <a href='http://download.boulder.ibm.com/ibmdl/pub/software/dw/linux390/docu/l390abi0.pdf'> S/390</a>, <a href='http://refspecs.linuxbase.org/elf/IA64-SysV-psABI.pdf'>Itanium</a>, <a href='http://refspecs.linuxbase.org/elf/mipsabi.pdf'>MIPS</a>, <a href='sparc.org/wp-content/uploads/2014/01/psABI3rd.pdf.gz'>SPARC</a>, <a href='http://refspecs.linuxbase.org/elf/elf-pa.pdf'>PA-RISK</a>, <a href='http://www.linux-m32r.org/cmn/m32r/M32R-elf-abi.pdf'>M32R</a> + </li> + <li> + <a href='https://refspecs.linuxbase.org/elf/gabi41.pdf'>"Generic ABI Standard"</a>, <a href='http://refspecs.linuxbase.org/elf/'>"ELF and ABI Standards"</a>, freestandards.org + </li> + <li> + <a href='http://events.linuxfoundation.org/sites/events/files/slides/Binary_Compatibility_for_library_devs.pdf'>"Binary compatibility for library developers"</a>, <a href='https://www.youtube.com/watch?v=PHrXGHDd9no'>Video</a>, Thiago Macieira + </li> + <li> + <a href='http://debconf14-video.debian.net/video/286/acc-for-abi-breaks'>"ACC for abi breaks"</a>, Dimitri Ledkov + </li> +</ul> + +<div class="footer"> + get the source code on GitHub : <a href="https://github.com/lvc/abi-compliance-checker">lvc/abi-compliance-checker</a> +</div> + +<br/> +<br/> + +</div> +</body> +</html> |