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.