]> git.donarmstrong.com Git - debhelper.git/blob - dh_shlibdeps
r538: * Make dh_installchangelogs install debian/NEWS files as well, as
[debhelper.git] / dh_shlibdeps
1 #!/usr/bin/perl -w
2
3 =head1 NAME
4
5 dh_shlibdeps - calculate shared library dependancies
6
7 =cut
8
9 use strict;
10 use Cwd;
11 use Debian::Debhelper::Dh_Lib;
12
13 =head1 SYNOPSIS
14
15 B<dh_shlibdeps> [S<I<debhelper options>>] [B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]
16
17 =head1 DESCRIPTION
18
19 dh_shlibdeps is a debhelper program that is responsible for calculating
20 shared library dependancies for packages.
21
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
24 a list of ELF executables and shared libraries it has found.
25
26 =head1 OPTIONS
27
28 =over 4
29
30 =item B<-u>I<params>, B<--dpkg-shlibdeps-params=>I<params>
31
32 =item B<--> I<params>
33
34 Pass "params" to L<dpkg-shlibdeps(1)>.
35
36 =item B<-X>I<item>, B<--exclude=>I<item>
37
38 Exclude files that contain "item" anywhere in their filename from being
39 passed to dpkg-shlibdeps. This will make their dependancies be ignored.
40 This may be useful in some situations, but use it with caution. This option
41 may be used more than once to exclude more than one thing.
42
43 =item B<-l>I<directory>[:directory:directory:..]
44
45 Before dpkg-shlibdeps is run, LD_LIBRARY_PATH will have added to it the 
46 specified directory (or directories -- separate with colons). This is
47 useful for multi-binary packages where a library is built in one
48 package and another package contains binaries linked against said
49 library. Relative paths will be made absolute for the benefit of
50 dpkg-shlibdeps.
51
52 =back
53
54 =cut
55
56 init();
57
58 # Add directory to library search path.
59 if ($dh{L_PARAMS}) {
60         my @paths=();
61         # Add to existing paths, if set.
62         push @paths, $ENV{'LD_LIBRARY_PATH'}
63                 if exists $ENV{'LD_LIBRARY_PATH'};
64         foreach (split(/:/, $dh{L_PARAMS})) {
65                 # Force the path absolute.
66                 if (m:^/:) {
67                         push @paths, $_;
68                 }
69                 else {
70                         push @paths, getcwd()."/$_";
71                 }
72         }
73         $dh{L_PARAMS}=join(':', @paths);
74         $ENV{'LD_LIBRARY_PATH'}=$dh{L_PARAMS};
75         verbose_print("LD_LIBRARY_PATH=$dh{L_PARAMS}");
76 }
77
78 foreach my $package (@{$dh{DOPACKAGES}}) {
79         my $tmp=tmpdir($package);
80         my $ext=pkgext($package);
81
82         my @filelist;
83         my $ff;
84
85         # Generate a list of ELF binaries in the package, ignoring any
86         # we were told to exclude.
87         my $find_options='';
88         if (defined($dh{EXCLUDE_FIND}) && $dh{EXCLUDE_FIND} ne '') {
89                 $find_options="! \\( $dh{EXCLUDE_FIND} \\)";
90         }
91         foreach my $file (split(/\n/,`find $tmp -type f \\( -perm +111 -or -name "*.so*" \\) $find_options`)) {
92                 # TODO this is slow, optimize. Ie, file can run once on
93                 # multiple files..
94                 $ff=`file "$file"`;
95                 if ($ff=~m/ELF/ && $ff!~/statically linked/) {
96                         push @filelist,$file;
97                 }
98         }
99
100         if (@filelist) {
101                 doit("dpkg-shlibdeps","-Tdebian/${ext}substvars",
102                         @{$dh{U_PARAMS}},@filelist);
103         }
104 }
105
106 =head1 SEE ALSO
107
108 L<debhelper(1)>
109
110 This program is a part of debhelper.
111
112 =head1 AUTHOR
113
114 Joey Hess <joeyh@debian.org>
115
116 =cut