OS Manuals

/usr/bin/dpkg-gensymbols

headers for dpkg

From dpkg-dev 1.23.11-r3 (os), captured 2026-11-05 by running dpkg-gensymbols --help (exit 0). permalink

Usage: dpkg-gensymbols [<option>...]

Options:
  -p<package>
          Generate symbols file for package.
  -e<library>
          Explicitly list libraries to scan.
  -P<package-build-dir>
          Set temporary build directory to use.
          [default: debian/tmp]
  -I<file>
          Force usage of <file> as reference symbols file instead of the
          default file.
  -l<library-path>
          Add directory to private shared library search list.
  -v<version>
          Version of the packages.
          [default: version from debian/changelog]
  -a<arch>
          Assume <arch> as host architecture when processing symbol files.
  -c<level>
          Compare generated symbols file with the reference template in the
          debian directory and fail if difference is too important; level goes
          from 0 for no check, to 4 for all checks.
          [default: 1]
          [env: DPKG_GENSYMBOLS_CHECK_LEVEL=]
  -t
          Write in template mode (tags are not processed and included in
          output).
  -O[<file>]
          Write to stdout (or <file>).
          [default: <package-build-dir>/DEBIAN/symbols]
  -q
          Enable quiet mode; never emit any warnings or generate a diff
          between generated symbols file and the reference template.
  -V
          Enable verbose mode; write deprecated symbols and pattern matching
          symbols as comments (in template mode only).
  -d
          Enable debugging mode.
  -?, --help
          Show this help message.
      --version
          Show the version.
Options (22)
OptionDescriptionSource
-p packageGenerate symbols file for package.help
-e libraryExplicitly list libraries to scan.help
-P package-build-dirSet temporary build directory to use.help
-I fileForce usage of <file> as reference symbols file instead of the default file.help
-l library-pathAdd directory to private shared library search list.help
-v versionVersion of the packages.help
-a archAssume <arch> as host architecture when processing symbol files.help
-c levelCompare generated symbols file with the reference template in the debian directory and fail if difference is too important;help
-tWrite the symbol file in template mode rather than the format compatible with deb-symbols(5).help + man
-O fileWrite to stdout (or <file>).help
-qKeep 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.help + man
-VEnable verbose mode;help + man
-dEnable debugging mode.help + man
-?, --helpShow the usage message and exit.help + man
--versionShow the version and exit.help + man
-Ppackage-build-dirScan package-build-dir instead of debian/tmp. (in the manual page but not in --help)man
-ppackageDefine the package name. (in the manual page but not in --help)man
-vversionDefine the package version. (in the manual page but not in --help)man
-elibrary-fileOnly analyze libraries explicitly listed instead of finding all public libraries. (in the manual page but not in --help)man
-ldirectoryPrepend directory to the list of directories to search for private shared libraries (since dpkg 1.19.1). (in the manual page but not in --help)man
-IfilenameUse filename as reference file to generate the symbols file that is integrated in the package itself. (in the manual page but not in --help)man
-aarchAssume arch as host architecture when processing symbol files. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.