ABILINT(1) Libabigail ABILINT(1)
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.
INVOCATION top
abilint [options] [<abi-file1>]
OPTIONS top
· --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.
AUTHOR top
Dodji Seketeli
COPYRIGHT top
2014-2016, Red Hat, Inc.
COLOPHON top
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 2017-07-05. If you dis‐
cover 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