abilint - validate an abigail ABI representation
abilint parses the native XML representation of an ABI as emitted by
abidw. Once it has parsed the XML representation of the ABI, abilint
builds and in-memory model from it. It then tries to save it back to
an XML form, to standard output. If that read-write operation suc‐
ceeds chances are the input XML ABI representation is meaningful.
Note that the main intent of this tool to help debugging issues in
the underlying Libabigail library.
Note also that abilint can also read an ELF input file, build the
in-memory model for its ABI, and serialize that model back into XML
to standard output. In that case, the ELF input file must be accom‐
panied with its debug information in the DWARF format.
· --help
Display a short help message and exits.
· --version | -v
Display the version of the program and exit.
· --debug-info-dir <path>
When reading an ELF input file which debug information is split
out into a separate file, this options tells abilint where to
find that separate debug information file.
Note that path must point to the root directory under which the
debug information is arranged in a tree-like manner. Under Red
Hat based systems, that directory is usually
<root>/usr/lib/debug.
Note also that this option is not mandatory for split debug
information installed by your system's package manager because
then abidiff knows where to find it.
· --diff
For XML inputs, perform a text diff between the input and the
memory model saved back to disk. This can help to spot issues
in the handling of the XML format by the underlying Libabigail
library.
· --noout
Do not display anything on standard output. The return code of
the command is the only way to know if the command succeeded.
· --suppressions | suppr <path-to-suppression-specifications-file>
Use a suppression specification file located at
path-to-suppression-specifications-file. Note that this option
can appear multiple times on the command line. In that case,
all of the provided suppression specification files are taken
into account. ABI artifacts matched by the suppression
specifications are suppressed from the output of this tool.
· --headers-dir | --hd <headers-directory-path-1>
Specifies where to find the public headers of the first shared
library that the tool has to consider. The tool will thus
filter out types that are not defined in public headers.
· --stdin | --
Read the input content from standard input.
· --tu
Expect the input XML to represent a single translation unit.
This page is part of the libabigail (ABI Generic Analysis and
Instrumentation Library) project. Information about the project can
be found at ⟨https://sourceware.org/libabigail/⟩. If you have a bug
report for this manual page, see
⟨http://sourceware.org/bugzilla/enter_bug.cgi?product=libabigail⟩.
This page was obtained from the project's upstream Git repository
⟨git://sourceware.org/git/libabigail.git⟩ on 2018-02-02. (At that
time, the date of the most recent commit that was found in the repos‐
itory was 2018-01-31.) If you discover any rendering problems in
this HTML version of the page, or you believe there is a better or
more up-to-date source for the page, or you have corrections or
improvements to the information in this COLOPHON (which is not part
of the original manual page), send a mail to man-pages@man7.org
Feb 02, 2018 ABILINT(1)