abi-compliance-checker 1.99.9-2 / usr / share / doc / abi-compliance-checker / Options.html

This file is indexed.

/usr/share/doc/abi-compliance-checker/Options.html is in abi-compliance-checker 1.99.9-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
<!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&amp;feed=atom" />
<link rel="stylesheet" href="/load.php?debug=false&amp;lang=en&amp;modules=mediawiki.legacy.commonPrint%2Cshared%7Cskins.monobook&amp;only=styles&amp;skin=monobook&amp;*" />
<!--[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&amp;lang=en&amp;modules=site&amp;only=styles&amp;skin=monobook&amp;*" />
<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&amp;lang=en&amp;modules=startup&amp;only=scripts&amp;skin=monobook&amp;*"></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 &lt;libs&gt; 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/&lt;target&gt; {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>
&#160;&#160;...</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>

APT Browse - Built by Thomas Orozco.