1DH_SHLIBDEPS(1) Debhelper DH_SHLIBDEPS(1)
2
3
4
6 dh_shlibdeps - calculate shared library dependencies
7
9 dh_shlibdeps [debhelper options] [-Lpackage] [-ldirectory] [-Xitem]
10 [-- params]
11
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
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
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
80 debhelper(7), dpkg-shlibdeps(1)
81
82 This program is a part of debhelper.
83
85 Joey Hess <joeyh@debian.org>
86
87
88
8911.4 2018-06-30 DH_SHLIBDEPS(1)