mirror of
git://sourceware.org/git/libabigail.git
synced 2025-02-07 17:21:37 +00:00
266fa9288e
This patch changed the revision number of the libabigail library to
make it reflect the fact that we are not in "release candidate" mode,
before the first 1.0 release. So the revision number is now "rc0".
The configuration manager has been updated to support version numbers
that are strings, so that it can supports things like "rc0".
Then, several libabigail tools have been modified to support the
--version option to display their version number.
* configure.ac: Set the version revision to "rc0".
* doc/manuals/abicompat.rst: Adjust manual for new --version
option.
* doc/manuals/abidiff.rst: Likewise.
* doc/manuals/abidw.rst: Likewise.
* doc/manuals/abilint.rst: Likewise.
* doc/manuals/abipkgdiff.rst: Likewise.
* include/abg-config.h (config::{m_format_minor, m_format_major}):
Make these be strings.
(config::{get,set}_format_minor_version_number): Make these return
strings.
(config::{get,set}_format_major_version_number): Make these return
or take strings.
(abigail_get_library_version): Make this take strings.
* src/abg-config.cc (config::config): Adjust.
(config::{get,set}_format_major_version_number): Make these return
or take strings.
(config::{get,set}_format_minor_version_number): Make these return
strings.
(abigail_get_library_version): Make this take strings.
* include/abg-version.h.in: Make the version variables be strings.
* src/abg-writer.cc (write_translation_unit): The version numbers
are now strings so adjust.
* tools/{abicompat,abidiff,abidw,abilint,abipkgdiff,abisym}.cc
(options::display_version): New data member.
(options::options): Initialize it.
(display_usage): Add documentation for new --version option.
(parse_command_line): Parse new --version option.
(main): Support --version.
Signed-off-by: Dodji Seketeli <dodji@redhat.com>
74 lines
2.2 KiB
ReStructuredText
74 lines
2.2 KiB
ReStructuredText
=======
|
|
abilint
|
|
=======
|
|
|
|
abilint parses the native XML representation of an ABI as emitted by
|
|
:doc:`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 succeeds 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
|
|
accompanied with its debug information in the `DWARF`_ format.
|
|
|
|
Invocation
|
|
==========
|
|
|
|
::
|
|
|
|
abilint [options] [<abi-file1>]
|
|
|
|
Options
|
|
=======
|
|
|
|
* ``--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.
|
|
|
|
* ``--stdin | --``
|
|
|
|
Read the input content from standard input.
|
|
|
|
* ``--tu``
|
|
|
|
Expect the input XML to represent a single translation unit.
|
|
|
|
.. _ELF: http://en.wikipedia.org/wiki/Executable_and_Linkable_Format
|
|
.. _DWARF: http://www.dwarfstd.org
|