|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | AUTHOR | COLOPHON |
|
|
|
DH_SHLIBDEPS(1) Debhelper DH_SHLIBDEPS(1)
dh_shlibdeps - calculate shared library dependencies
dh_shlibdeps [debhelper options] [-Lpackage] [-ldirectory]
[-Xitem] [-- params]
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 found.
-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.
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:
dh_makeshlibs
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
debhelper(7), dpkg-shlibdeps(1)
This program is a part of debhelper.
Joey Hess <joeyh@debian.org>
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 2025-08-11.
(At that time, the date of the most recent commit that was found
in the repository was 2025-08-10.) 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
man-pages@man7.org
13.15.3 2024-06-07 DH_SHLIBDEPS(1)
Pages that refer to this page: dh(1), debhelper(7)