1DH_SHLIBDEPS(1)                    Debhelper                   DH_SHLIBDEPS(1)
2
3
4

NAME

6       dh_shlibdeps - calculate shared library dependencies
7

SYNOPSIS

9       dh_shlibdeps [debhelper options] [-Lpackage] [-ldirectory] [-Xitem]
10       [-- params]
11

DESCRIPTION

13       dh_shlibdeps is a debhelper program that is responsible for calculating
14       shared library dependencies for packages.
15
16       This program is merely a wrapper around dpkg-shlibdeps(1) that calls it
17       once for each package listed in the control file, passing it a list of
18       ELF executables and shared libraries it has found.
19

OPTIONS

21       -Xitem, --exclude=item
22           Exclude files that contain item anywhere in their filename from
23           being passed to dpkg-shlibdeps. This will make their dependencies
24           be ignored.  This may be useful in some situations, but use it with
25           caution. This option may be used more than once to exclude more
26           than one thing.
27
28       -- params
29           Pass params to dpkg-shlibdeps(1).
30
31       -uparams, --dpkg-shlibdeps-params=params
32           This is another way to pass params to dpkg-shlibdeps(1).  It is
33           deprecated; use -- instead.
34
35       -ldirectory[:directory ...]
36           With recent versions of dpkg-shlibdeps, this option is generally
37           not needed.
38
39           It tells dpkg-shlibdeps (via its -l parameter), to look for private
40           package libraries in the specified directory (or directories --
41           separate with colons). With recent versions of dpkg-shlibdeps, this
42           is mostly only useful for packages that build multiple flavors of
43           the same library, or other situations where the library is
44           installed into a directory not on the regular library search path.
45
46       -Lpackage, --libpackage=package
47           With recent versions of dpkg-shlibdeps, this option is generally
48           not needed, unless your package builds multiple flavors of the same
49           library or is relying on debian/shlibs.local for an internal
50           library.
51
52           It tells dpkg-shlibdeps (via its -S parameter) to look first in the
53           package build directory for the specified package, when searching
54           for libraries, symbol files, and shlibs files.
55
56           If needed, this can be passed multiple times with different package
57           names.
58

EXAMPLES

60       Suppose that your source package produces libfoo1, libfoo-dev, and
61       libfoo-bin binary packages. libfoo-bin links against libfoo1, and
62       should depend on it. In your rules file, first run dh_makeshlibs, then
63       dh_shlibdeps:
64
65               dh_makeshlibs
66               dh_shlibdeps
67
68       This will have the effect of generating automatically a shlibs file for
69       libfoo1, and using that file and the libfoo1 library in the
70       debian/libfoo1/usr/lib directory to calculate shared library dependency
71       information.
72
73       If a libbar1 package is also produced, that is an alternate build of
74       libfoo, and is installed into /usr/lib/bar/, you can make libfoo-bin
75       depend on libbar1 as follows:
76
77               dh_shlibdeps -Llibbar1 -l/usr/lib/bar
78

SEE ALSO

80       debhelper(7), dpkg-shlibdeps(1)
81
82       This program is a part of debhelper.
83

AUTHOR

85       Joey Hess <joeyh@debian.org>
86
87
88
8913.7.1                            2022-04-22                   DH_SHLIBDEPS(1)
Impressum