NAME¶
check-symbols - verify symbols exported by a new library version
SYNOPSIS¶
check-symbols <
source-package> [
DEBDIR]
DESCRIPTION¶
To verify the symbols exported by a new library version, run
check-symbols with the name of the source package as argument.
check-symbols will first determine the symbols exported by the existing
and installed library version, then install the new library and compare the
symbols exported by the new library version with the symbols exported by the
old version. For each of the symbols found,
check-symbols will list if
the symbol is new, unchanged or has been removed in the new library version.
In case the source package contains multiple binary library packages, all
library files in each of the binary packages will be verified.
check-symbols uses
nm -D to determine the exported symbols of the
libraries.
If no value is given for DEBDIR, the script will assume the new library deb
files are stored in /var/cache/pbuilder/result.
EXAMPLES¶
check-symbols telepathy-glib .
- This will:
- • Use nm -D to determine the exported symbols of the
old,
- installed versions of the libraries provided by telepathy-glib.
- • Install the binary libraries provided by the new version of
- telepathy-glib.
- • Compare the output of nm -D of the new libraries with
the
- output of the old version.
- • List the result in diff format.
BUGS¶
Please report bugs on:
https://bugs.launchpad.net/ubuntu/+source/ubuntu-dev-tools/
SEE ALSO¶
nm(1)
AUTHOR¶
check-symbols was written by Daniel Holbach
<daniel.holbach@ubuntu.com> and this manpage by Albert Damen
<albrt@gmx.net>. Both are licensed under the GNU General Public License,
version 2.