dh_shlibdeps(1) — Linux manual page


DH_SHLIBDEPS(1)                 Debhelper                DH_SHLIBDEPS(1)

NAME         top

       dh_shlibdeps - calculate shared library dependencies

SYNOPSIS         top

       dh_shlibdeps [debhelper options] [-Lpackage] [-ldirectory]
       [-Xitem] [-- params]

DESCRIPTION         top

       dh_shlibdeps is a debhelper program that is responsible for
       calculating shared library dependencies for packages.

       This program is merely a wrapper around dpkg-shlibdeps(1) that
       calls it once for each package listed in the control file,
       passing it a list of ELF executables and shared libraries it has

OPTIONS         top

       -Xitem, --exclude=item
           Exclude files that contain item anywhere in their filename
           from being passed to dpkg-shlibdeps. This will make their
           dependencies be ignored.  This may be useful in some
           situations, but use it with caution. This option may be used
           more than once to exclude more than one thing.

       -- params
           Pass params to dpkg-shlibdeps(1).

       -uparams, --dpkg-shlibdeps-params=params
           This is another way to pass params to dpkg-shlibdeps(1).  It
           is deprecated; use -- instead.

       -ldirectory[:directory ...]
           With recent versions of dpkg-shlibdeps, this option is
           generally not needed.

           It tells dpkg-shlibdeps (via its -l parameter), to look for
           private package libraries in the specified directory (or
           directories -- separate with colons). With recent versions of
           dpkg-shlibdeps, this is mostly only useful for packages that
           build multiple flavors of the same library, or other
           situations where the library is installed into a directory
           not on the regular library search path.

       -Lpackage, --libpackage=package
           With recent versions of dpkg-shlibdeps, this option is
           generally not needed, unless your package builds multiple
           flavors of the same library or is relying on
           debian/shlibs.local for an internal library.

           It tells dpkg-shlibdeps (via its -S parameter) to look first
           in the package build directory for the specified package,
           when searching for libraries, symbol files, and shlibs files.

           If needed, this can be passed multiple times with different
           package names.

EXAMPLES         top

       Suppose that your source package produces libfoo1, libfoo-dev,
       and libfoo-bin binary packages. libfoo-bin links against libfoo1,
       and should depend on it. In your rules file, first run
       dh_makeshlibs, then dh_shlibdeps:


       This will have the effect of generating automatically a shlibs
       file for libfoo1, and using that file and the libfoo1 library in
       the debian/libfoo1/usr/lib directory to calculate shared library
       dependency information.

       If a libbar1 package is also produced, that is an alternate build
       of libfoo, and is installed into /usr/lib/bar/, you can make
       libfoo-bin depend on libbar1 as follows:

               dh_shlibdeps -Llibbar1 -l/usr/lib/bar

SEE ALSO         top

       debhelper(7), dpkg-shlibdeps(1)

       This program is a part of debhelper.

AUTHOR         top

       Joey Hess <joeyh@debian.org>

COLOPHON         top

       This page is part of the debhelper (helper programs for
       debian/rules) project.  Information about the project can be
       found at [unknown -- if you know, please contact man-
       pages@man7.org] If you have a bug report for this manual page,
       send it to submit@bugs.debian.org.  This page was obtained from
       the project's upstream Git repository
       ⟨https://salsa.debian.org/debian/debhelper.git⟩ on 2023-12-22.
       (At that time, the date of the most recent commit that was found
       in the repository was 2023-12-19.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

13.11.7                        2023-09-12                DH_SHLIBDEPS(1)

Pages that refer to this page: dh(1)debhelper(7)