← Back to branch summary

~noskcaj/ubuntu/saucy/debhelper/saucy

« back to all changes in this revision

Viewing changes to dh_shlibdeps

  • Committer: Bazaar Package Importer
  • Author(s): أحمد المحمودي (Ahmed El-Mahmoudy)
  • Date: 2011-02-07 17:16:49 UTC
  • mfrom: (1.4.21 sid)
  • Revision ID: james.westby@ubuntu.com-20110207171649-v8k6uowavom83cxt
Tags: 8.1.0ubuntu1
https://launchpad.net/bugs/714705
* Merge with Debian (LP: #714705); remaining changes:
  - dh_installinit: Add --upstart-only and --onlyscripts-upstart modes.
  - Add various autoscripts for above: postinst-upstart,
    postinst-upstart-replace, postinst-upstart-restart,
    prerm-upstart, prerm-upstart-norestart, preinst-removeconffile.
  - dh_installudev: Change default init.d symlink priority to 40.
  - dh_installchangelogs: Do not install upstream changelog in compat level
    7. This floods packages with huge upstream changelogs which take
    precious CD space.
  - dh_strip, dh_makeshlibs: use triplet-objdump, triplet-objcopy and
    triplet-strip from cross-binutils when cross-compiling; Debian #412118.
  - add dh_apparmor and autoscripts
  - debian/rules: override build target to set executable bit for
    dh_apparmor before actually running dh build, that is in order to get
    the manpage built for dh_apparmor.

Show diffs side-by-side

added added

removed removed

Lines of Context:
dh_shlibdeps
16
16
 
17
17
=head1 DESCRIPTION
18
18
 
19
 
dh_shlibdeps is a debhelper program that is responsible for calculating
 
19
B<dh_shlibdeps> is a debhelper program that is responsible for calculating
20
20
shared library dependencies for packages.
21
21
 
22
22
This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it
23
 
once for each package listed in the control file, passing it
 
23
once for each package listed in the F<control> file, passing it
24
24
a list of ELF executables and shared libraries it has found.
25
25
 
26
26
=head1 OPTIONS
29
29
 
30
30
=item B<-X>I<item>, B<--exclude=>I<item>
31
31
 
32
 
Exclude files that contain "item" anywhere in their filename from being
33
 
passed to dpkg-shlibdeps. This will make their dependencies be ignored.
 
32
Exclude files that contain F<item> anywhere in their filename from being
 
33
passed to B<dpkg-shlibdeps>. This will make their dependencies be ignored.
34
34
This may be useful in some situations, but use it with caution. This option
35
35
may be used more than once to exclude more than one thing.
36
36
 
37
37
=item B<--> I<params>
38
38
 
39
 
Pass "params" to L<dpkg-shlibdeps(1)>.
 
39
Pass I<params> to L<dpkg-shlibdeps(1)>.
40
40
 
41
41
=item B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>
42
42
 
43
 
This is another way to pass I<params> to L<dpkg-deb(1)>.
 
43
This is another way to pass I<params> to L<dpkg-shlibdeps(1)>.
44
44
It is deprecated; use B<--> instead.
45
45
 
46
 
=item B<-l>I<directory>[:directory:directory:..]
 
46
=item B<-l>I<directory>[B<:>I<directory> ...]
47
47
 
48
 
With recent versions of dpkg-shlibdeps, this option is generally not
 
48
With recent versions of B<dpkg-shlibdeps>, this option is generally not
49
49
needed.
50
50
 
51
 
Before dpkg-shlibdeps is run, LD_LIBRARY_PATH will have added to it the 
 
51
Before B<dpkg-shlibdeps> is run, B<LD_LIBRARY_PATH> will have added to it the 
52
52
specified directory (or directories -- separate with colons). With recent
53
 
versions of dpkg-shlibdeps, this is mostly only useful for packages that
 
53
versions of B<dpkg-shlibdeps>, this is mostly only useful for packages that
54
54
build multiple flavors of the same library, or other situations where
55
55
the library is installed into a directory not on the regular library search
56
56
path.
57
57
 
58
58
=item B<-L>I<package>, B<--libpackage=>I<package>
59
59
 
60
 
With recent versions of dpkg-shlibdeps, this option is generally not
 
60
With recent versions of B<dpkg-shlibdeps>, this option is generally not
61
61
needed, unless your package builds multiple flavors of the same library.
62
62
 
63
 
It tells dpkg-shlibdeps (via its -S parameter) to look first in the package
 
63
It tells B<dpkg-shlibdeps> (via its B<-S> parameter) to look first in the package
64
64
build directory for the specified package, when searching for libraries,
65
65
symbol files, and shlibs files.
66
66
 
70
70
 
71
71
Suppose that your source package produces libfoo1, libfoo-dev, and
72
72
libfoo-bin binary packages. libfoo-bin links against libfoo1, and should
73
 
depend on it. In your rules file, first run dh_makeshlibs, then dh_shlibdeps:
 
73
depend on it. In your rules file, first run B<dh_makeshlibs>, then B<dh_shlibdeps>:
74
74
 
75
75
        dh_makeshlibs
76
76
        dh_shlibdeps
77
77
 
78
78
This will have the effect of generating automatically a shlibs file for
79
79
libfoo1, and using that file and the libfoo1 library in the
80
 
debian/libfoo1/usr/lib directory to calculate shared library dependency
 
80
F<debian/libfoo1/usr/lib> directory to calculate shared library dependency
81
81
information.
82
82
 
83
83
If a libbar1 package is also produced, that is an alternate build of
84
 
libfoo, and is installed into /usr/lib/bar/, you can make libfoo-bin depend
 
84
libfoo, and is installed into F</usr/lib/bar/>, you can make libfoo-bin depend
85
85
on libbar1 as follows:
86
86
 
87
87
        dh_shlibdeps -Llibbar1 -l/usr/lib/bar