PKGKDE-GENSYMBOLS(1)

📦 version 0.22.1ubuntu2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 PKGKDE-GENSYMBOLS 💖

okay so bestie, welcome to pkgkde-gensymbols — she's a Debian KDE dpkg-gensymbols wrapper and she's here to help you with your symbols files. no cap, she's iconic.

✨ NAME ✨

pkgkde-gensymbols — a helper tool for Debian pkg-kde symbols files. literally what it says on the tin, and she ate.

🌸 SYNOPSIS 🌸

pkgkde-gensymbols [
yes babe that's the whole synopsis, i'm not even playing. the vibes are mysterious and we respect that.

🦋 DESCRIPTION 🦋

pkgkde-gensymbols is a wrapper around dpkg-gensymbols that provides additional support for tracking C++ symbols such as template instantiated symbols. she's giving main character energy for all your C++ symbol-tracking needs, fr fr.

See dpkg-gensymbols(1) for more information about maintaining symbols files. go read it, i'll wait. 💅

💅 OPTIONS 💅

  • -Ppackage-build-dir — scan package-build-dir instead of debian/tmp. switching up the location, periodt.
  • -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). like, she needs to know which one you mean bestie.
  • -vversion — define the package version. Defaults to the version extracted from debian/changelog. Required if called outside of a source package tree. no changelog, no default, you gotta tell her.
  • -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). so like, pattern matching slay.
  • -Ifilename — use filename as reference file to generate the symbols file that is integrated in the package itself. reference material, we love to see it.
  • -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. lowkey genius behavior.
  • -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. template mode stays unfiltered, and honestly? relatable.
  • -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. so dramatic, but the checks are real.

  • -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). silent but the checks still be checking, iykyk.
  • -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. cross-arch vibes, as long as the binaries are there.
  • -d — enable debug mode. Numerous messages are displayed to explain what dpkg-gensymbols does. she's gonna overshare and honestly we're here for it.
  • -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. extra commentary, extra context, we love a thorough queen.
  • -?, --help — show the usage message and exit. when you just need a little help bestie.
  • --version — show the version and exit. know your queen's era.

🎀 NOTES 🎀

This man page was based on the pkg-kde symbols file help page and the dpkg-gensymbols(1) man page. credit where credit is due, no plagiarism here.

🌈 SEE ALSO 🌈

and that's the whole page, bestie!! this absolute icon of a man page is version 0.15, dated 2015-04-18, and she's still serving. go forth and track those C++ symbols, you've got this. 💖✨🦋💅

📦 where this page comes from