pkgkde-gensymbols - a helper tool for Debian pkg-kde
symbols files.
pkgkde-gensymbols is a wrapper around dpkg-gensymbols that
provides additional support for tracking C++ symbols such as template
instantiated symbols. See dpkg-gensymbols(1) for more information
about maintaining symbols files.
- -Ppackage-build-dir
- Scan package-build-dir instead of debian/tmp.
- -ppackage
- Define the package name. Required if more than one binary package is
listed in debian/control (or if there's no debian/control file).
- -vversion
- Define the package version. Defaults to the version extracted from
debian/changelog. Required if called outside of a source package
tree.
- -elibrary-file
- Only analyze libraries explicitly listed instead of finding all public
libraries. You can use shell patterns used for pathname expansions (see
the File::Glob(3perl) manual page for details) in
library-file to match multiple libraries with a single argument
(otherwise you need multiple -e).
- -Ifilename
- Use filename as reference file to generate the symbols file that is
integrated in the package itself.
- -O[filename]
- Print the generated symbols file to standard output or to filename
if specified, rather than to debian/tmp/DEBIAN/symbols (or
package-build-dir/DEBIAN/symbols if -P was used). If
filename is pre-existing, its contents are used as basis for the
generated symbols file. You can use this feature to update a symbols file
so that it matches a newer upstream version of your library.
- -t
- Write the symbol file in template mode rather than the format compatible
with deb-symbols(5). The main difference is that in the template
mode symbol names and tags are written in their original form contrary to
the post-processed symbol names with tags stripped in the compatibility
mode. Moreover, some symbols might be omitted when writing a standard
deb-symbols(5) file (according to the tag processing rules) while
all symbols are always written to the symbol file template.
- -c[0-4]
- Define the checks to do when comparing the generated symbols file with the
template file used as starting point. By default the level is 1.
Increasing levels do more checks and include all checks of lower levels.
Level 0 never fails. Level 1 fails if some symbols have disappeared. Level
2 fails if some new symbols have been introduced. Level 3 fails if some
libraries have disappeared. Level 4 fails if some libraries have been
introduced.
This value can be overridden by the environment variable
DPKG_GENSYMBOLS_CHECK_LEVEL.
- -q
- Keep quiet and never generate a diff between generated symbols file and
the template file used as starting point or show any warnings about
new/lost libraries or new/lost symbols. This option only disables
informational output but not the checks themselves (see -c
option).
- -aarch
- Assume arch as host architecture when processing symbol files. Use
this option to generate a symbol file or diff for any architecture
provided its binaries are already available.
- -d
- Enable debug mode. Numerous messages are displayed to explain what
dpkg-gensymbols does.
- -V
- Enable verbose mode. The generated symbols file contains deprecated
symbols as comments. Furthermore in template mode, pattern symbols are
followed by comments listing real symbols that have matched the
pattern.
- -?, --help
- Show the usage message and exit.
- --version
- Show the version and exit.
This man page was based on the pkg-kde symbols file help page and
the dpkg-gensymbols(1) man page.
https://qt-kde-team.pages.debian.net/symbolfiles.html
https://people.redhat.com/drepper/symbol-versioning
https://people.redhat.com/drepper/goodpractice.pdf
https://people.redhat.com/drepper/dsohowto.pdf
dpkg-gensymbols(1), deb-symbols(5),
dpkg-shlibdeps(1).