X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_shlibdeps;h=a41732fcee1678c9c5a1814334760e2cf25f96f8;hb=18a0da8092ea9f3dc48bca92b36f592af25a608d;hp=f9199c3f46f2bb48df15333c7a0fdbaa78b29f0a;hpb=f0c3197c8a4d3c3e2f3e6c403ffe52555c871181;p=debhelper.git diff --git a/dh_shlibdeps b/dh_shlibdeps index f9199c3..a41732f 100755 --- a/dh_shlibdeps +++ b/dh_shlibdeps @@ -2,7 +2,7 @@ =head1 NAME -dh_shlibdeps - calculate shared library dependancies +dh_shlibdeps - calculate shared library dependencies =cut @@ -12,50 +12,88 @@ use Debian::Debhelper::Dh_Lib; =head1 SYNOPSIS - dh_shlibdeps [debhelper options] [-ldirectory] [-Xitem] [-- params] +B [S>] [B<-L>I] [B<-l>I] [B<-X>I] [S I>] =head1 DESCRIPTION -dh_shlibdeps is a debhelper program that is responsible for calculating -shared library dependancies for packages. +B is a debhelper program that is responsible for calculating +shared library dependencies for packages. This program is merely a wrapper around L that calls it -once for each package listed in the control file, passing it +once for each package listed in the F file, passing it a list of ELF executables and shared libraries it has found. =head1 OPTIONS =over 4 -=item B<-u>I, B<--dpkg-shlibdeps-params=>I +=item B<-X>I, B<--exclude=>I + +Exclude files that contain F anywhere in their filename from being +passed to B. 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. =item B<--> I -Pass "params" to L. +Pass I to L. -=item B<-X>I, B<--exclude=>I +=item B<-u>I, B<--dpkg-shlibdeps-params=>I -Exclude files that contain "item" anywhere in their filename from being -passed to dpkg-shlibdeps. This will make their dependancies 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. +This is another way to pass I to L. +It is deprecated; use B<--> instead. + +=item B<-l>I[B<:>I ...] + +With recent versions of B, this option is generally not +needed. + +Before B is run, B will have added to it the +specified directory (or directories -- separate with colons). With recent +versions of B, 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. + +=item B<-L>I, B<--libpackage=>I -=item B<-l>I[:directory:directory:..] +With recent versions of B, this option is generally not +needed, unless your package builds multiple flavors of the same library. -Before dpkg-shlibdeps is run, LD_LIBRARY_PATH will have added to it the -specified directory (or directories -- separate with colons). This is -useful for multi-binary packages where a library is built in one -package and another package contains binaries linked against said -library. Relative paths will be made absolute for the benefit of -dpkg-shlibdeps. +It tells B (via its B<-S> parameter) to look first in the package +build directory for the specified package, when searching for libraries, +symbol files, and shlibs files. =back +=head1 EXAMPLES + +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 B, then B: + + 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 +F 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 F, you can make libfoo-bin depend +on libbar1 as follows: + + dh_shlibdeps -Llibbar1 -l/usr/lib/bar + =cut -init(); +init(options => { + "L|libpackage=s" => \$dh{LIBPACKAGE}, + "dpkg-shlibdeps-params=s", => \$dh{U_PARAMS}, + "l=s", => \$dh{L_PARAMS}, +}); -# Add directory to library search path. if ($dh{L_PARAMS}) { my @paths=(); # Add to existing paths, if set. @@ -67,18 +105,25 @@ if ($dh{L_PARAMS}) { push @paths, $_; } else { - push @paths, getcwd()."/$_"; + push @paths, "/$_"; } } $dh{L_PARAMS}=join(':', @paths); - $ENV{'LD_LIBRARY_PATH'}=$dh{L_PARAMS}; - verbose_print("LD_LIBRARY_PATH=$dh{L_PARAMS}"); +} + +if (defined $dh{V_FLAG}) { + warning("You probably wanted to pass -V to dh_makeshlibs, it has no effect on dh_shlibdeps"); } foreach my $package (@{$dh{DOPACKAGES}}) { my $tmp=tmpdir($package); my $ext=pkgext($package); + # dpkg-shlibdeps expects this directory to exist + if (! -d "$tmp/DEBIAN") { + doit("install","-o",0,"-g",0,"-d","$tmp/DEBIAN"); + } + my @filelist; my $ff; @@ -88,8 +133,11 @@ foreach my $package (@{$dh{DOPACKAGES}}) { if (defined($dh{EXCLUDE_FIND}) && $dh{EXCLUDE_FIND} ne '') { $find_options="! \\( $dh{EXCLUDE_FIND} \\)"; } - foreach my $file (split(/\n/,`find $tmp -type f \\( -perm +111 -or -name "*.so*" \\) $find_options`)) { - # TODO: this is slow, optimize. Ie, file can run once on multiple files.. + foreach my $file (split(/\n/,`find $tmp -type f \\( -perm +111 -or -name "*.so*" -or -name "*.cmxs" \\) $find_options -print`)) { + # Prune directories that contain separated debug symbols. + next if $file=~m!^\Q$tmp\E/usr/lib/debug/(lib|lib64|usr|bin|sbin|opt|dev|emul)/!; + # TODO this is slow, optimize. Ie, file can run once on + # multiple files.. $ff=`file "$file"`; if ($ff=~m/ELF/ && $ff!~/statically linked/) { push @filelist,$file; @@ -97,13 +145,36 @@ foreach my $package (@{$dh{DOPACKAGES}}) { } if (@filelist) { - doit("dpkg-shlibdeps","-Tdebian/${ext}substvars.debhelper",@{$dh{U_PARAMS}},'-dDepends',@filelist); + my @opts; + if (defined $dh{LIBPACKAGE} && length $dh{LIBPACKAGE}) { + @opts=("-S".tmpdir($dh{LIBPACKAGE})); + } + + push @opts, "-tudeb" if is_udeb($package); + + my $ld_library_path_orig=$ENV{LD_LIBRARY_PATH}; + if ($dh{L_PARAMS}) { + $ENV{LD_LIBRARY_PATH}=$dh{L_PARAMS}; + verbose_print("LD_LIBRARY_PATH=$dh{L_PARAMS}"); + } + + doit("dpkg-shlibdeps","-Tdebian/${ext}substvars", + @opts,@{$dh{U_PARAMS}},@filelist); + + if ($dh{L_PARAMS}) { + if (defined $ld_library_path_orig) { + $ENV{LD_LIBRARY_PATH}=$ld_library_path_orig; + } + else { + delete $ENV{LD_LIBRARY_PATH}; + } + } } } =head1 SEE ALSO -L +L, L This program is a part of debhelper.