X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_makeshlibs;h=66e8b961d2d4658a176c6b097ed606f043a8d8b7;hb=18a0da8092ea9f3dc48bca92b36f592af25a608d;hp=1888ee2d54f46112dc2e79cbcf4fc0451c94b68d;hpb=58a5fcfd24ecc319d4f5cc632d32ef31ef14079e;p=debhelper.git diff --git a/dh_makeshlibs b/dh_makeshlibs index 1888ee2..66e8b96 100755 --- a/dh_makeshlibs +++ b/dh_makeshlibs @@ -2,7 +2,7 @@ =head1 NAME -dh_makeshlibs - automatically create shlibs file +dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols =cut @@ -11,15 +11,34 @@ use Debian::Debhelper::Dh_Lib; =head1 SYNOPSIS - dh_makeshlibs [debhelper options] [-mmajor] [-V[dependancies]] [-n] +B [S>] [B<-m>I] [B<-V>I<[dependencies]>] [B<-n>] [B<-X>I] [S I>] =head1 DESCRIPTION -dh_makeshlibs is a debhelper program that automatically scans for shared +B is a debhelper program that automatically scans for shared libraries, and generates a shlibs file for the libraries it finds. -It also adds a call to ldconfig in the postinst and postrm scripts (in -DH_COMPAT=3 mode and above only). +It also adds a call to ldconfig in the F and F scripts (in +v3 mode and above only) to any packages in which it finds shared libraries. + +Packages that support multiarch are detected, and +a Pre-Dependency on multiarch-support is set in ${misc:Pre-Depends} ; +you should make sure to put that token into an appropriate place in your +debian/control file for packages supporting multiarch. + +=head1 FILES + +=over 4 + +=item debian/I.symbols + +=item debian/I.symbols.I + +These symbols files, if present, are passed to L to +be processed and installed. Use the I specific names if you need +to provide different symbols files for different architectures. + +=back =head1 OPTIONS @@ -27,82 +46,134 @@ DH_COMPAT=3 mode and above only). =item B<-m>I, B<--major=>I -Instead of trying to guess the major number of the library from the -filename of the library, use the major number specified after the -m parameter. +Instead of trying to guess the major number of the library with objdump, +use the major number specified after the -m parameter. This is much less +useful than it used to be, back in the bad old days when this program +looked at library filenames rather than using objdump. -=item B<-V>, B<-V>I +=item B<-V>, B<-V>I -=item B<--version-info>, B<--version-info=>I +=item B<--version-info>, B<--version-info=>I By default, the shlibs file generated by this program does not make packages depend on any particular version of the package containing the shared -library. It may be necessary for you to add some version dependancy -information to the shlibs file. If -V is specified with no dependancy -information, the current version of the package is plugged into a -dependancy that looks like "packagename (>= packageversion)". If -V is specified with -parameters, the parameters can be used to specify the exact dependancy -information needed (be sure to include the package name). +library. It may be necessary for you to add some version dependency +information to the shlibs file. If B<-V> is specified with no dependency +information, the current upstream version of the package is plugged into a +dependency that looks like "I B<(E>= IB<)>". Note that in +debhelper compatibility levels before v4, the Debian part of the package +version number is also included. If B<-V> is specified with parameters, the +parameters can be used to specify the exact dependency information needed +(be sure to include the package name). + +Beware of using B<-V> without any parameters; this is a conservative setting +that always ensures that other packages' shared library dependencies are at +least as tight as they need to be (unless your library is prone to changing +ABI without updating the upstream version number), so that if the +maintainer screws up then they won't break. The flip side is that packages +might end up with dependencies that are too tight and so find it harder to +be upgraded. =item B<-n>, B<--noscripts> -Do not modify postinst/postrm scripts. +Do not modify F/F scripts. + +=item B<-X>I, B<--exclude=>I + +Exclude files that contain I anywhere in their filename or directory +from being treated as shared libraries. + +=item B<--add-udeb=>I + +Create an additional line for udebs in the shlibs file and use I as the +package name for udebs to depend on instead of the regular library package. + +=item B<--> I + +Pass I to L. =back =head1 EXAMPLES - dh_makeshlibs +=over 4 + +=item B -Assuming this is a package named libfoobar1, generates a shlibs file that +Assuming this is a package named F, generates a shlibs file that looks something like: libfoobar 1 libfoobar1 - dh_makeshlibs -V +=item B -Assuming the current version of the package is 1.0-3, generates a shlibs +Assuming the current version of the package is 1.1-3, generates a shlibs file that looks something like: - libfoobar 1 libfoobar1 (>= 1.0-3) + libfoobar 1 libfoobar1 (>= 1.1) - dh_makeshlibs -V 'libfoobar1 (>= 1.0)' +=item B= 1.0)'> Generates a shlibs file that looks something like: libfoobar 1 libfoobar1 (>= 1.0) -=head1 NOTES - -There is no guarantee that the program will get the shlibs file right. For -example, it may not correctly guess the major number of your package. In -cases like these (and perhaps in general, just to be safe), it is better to -create a debian/shlibs file by hand, or force it to use the correct major -number by specifying the -m parameter. +=back =cut -init(); +init(options => { + "m=s", => \$dh{M_PARAMS}, + "major=s" => \$dh{M_PARAMS}, + "version-info:s" => \$dh{V_FLAG}, + "add-udeb=s" => \$dh{SHLIBS_UDEB}, +}); + +my $objdump=cross_command("objdump"); +my $multiarch=dpkg_architecture_value("DEB_HOST_MULTIARCH"); foreach my $package (@{$dh{DOPACKAGES}}) { + next if is_udeb($package); + my $tmp=tmpdir($package); my %seen; my $need_ldconfig = 0; + my $is_multiarch = 0; doit("rm", "-f", "$tmp/DEBIAN/shlibs"); - open (FIND, "find $tmp -xtype f -name '*.so*' |"); + # So, we look for files or links to existing files with names that + # match "*.so.*". And we only look at real files not + # symlinks, so we don't accidentally add shlibs data to -dev + # packages. This may have a few false positives, which is ok, + # because only if we can get a library name and a major number from + # objdump is anything actually added. + my $exclude=''; + my (@udeb_lines, @lib_files); + if (defined($dh{EXCLUDE_FIND}) && $dh{EXCLUDE_FIND} ne '') { + $exclude="! \\( $dh{EXCLUDE_FIND} \\) "; + } + open (FIND, "find $tmp -type f \\( -name '*.so' -or -name '*.so.*' \\) $exclude |"); while () { - my $library; - my $major; - - chomp; - # The second evil regexp is for db3, whose author should - # be shot. - if (m#.*/([^/]*)\.so\.(\d*)\.?# || m#.*/([^/]*)-([^\s/]+)\.so$#) { - $library = $1; - $major = $2; + my ($library, $major); + push @lib_files, $_; + if (defined $multiarch && $multiarch ne '' && m,/$multiarch/,) { + $is_multiarch=1; + } + my $ret=`$objdump -p $_`; + if ($ret=~m/\s+SONAME\s+(.+)\.so\.(.+)/) { + # proper soname format + $library=$1; + $major=$2; + } + elsif ($ret=~m/\s+SONAME\s+(.+)-(.+)\.so/) { + # idiotic crap soname format + $library=$1; + $major=$2; } + if (defined($dh{M_PARAMS}) && $dh{M_PARAMS} ne '') { $major=$dh{M_PARAMS}; } + if (! -d "$tmp/DEBIAN") { doit("install","-d","$tmp/DEBIAN"); } @@ -112,10 +183,17 @@ foreach my $package (@{$dh{DOPACKAGES}}) { $deps=$dh{V_FLAG}; } else { - # Call isnative becuase it sets $dh{VERSION} + # Call isnative because it sets $dh{VERSION} # as a side effect. isnative($package); - $deps="$package (>= $dh{VERSION})"; + my $version = $dh{VERSION}; + # Old compatibility levels include the + # debian revision, while new do not. + if (! compat(3)) { + # Remove debian version, if any. + $version =~ s/-[^-]+$//; + } + $deps="$package (>= $version)"; } } if (defined($library) && defined($major) && defined($deps) && @@ -126,11 +204,22 @@ foreach my $package (@{$dh{DOPACKAGES}}) { if (! $seen{$line}) { $seen{$line}=1; complex_doit("echo '$line' >>$tmp/DEBIAN/shlibs"); + if (defined($dh{SHLIBS_UDEB}) && $dh{SHLIBS_UDEB} ne '') { + my $udeb_deps = $deps; + $udeb_deps =~ s/\Q$package\E/$dh{SHLIBS_UDEB}/e; + $line="udeb: "."$library $major $udeb_deps"; + push @udeb_lines, $line; + } } } } close FIND; + # Write udeb: lines last. + foreach (@udeb_lines) { + complex_doit("echo '$_' >>$tmp/DEBIAN/shlibs"); + } + # New as of dh_v3. if (! compat(2) && ! $dh{NOSCRIPTS} && $need_ldconfig) { autoscript($package,"postinst","postinst-makeshlibs"); @@ -139,13 +228,36 @@ foreach my $package (@{$dh{DOPACKAGES}}) { if (-e "$tmp/DEBIAN/shlibs") { doit("chmod",644,"$tmp/DEBIAN/shlibs"); - doit("chown","0.0","$tmp/DEBIAN/shlibs"); + doit("chown","0:0","$tmp/DEBIAN/shlibs"); + } + + # dpkg-gensymbols files + my $symbols=pkgfile($package, "symbols"); + if (-e $symbols) { + my @liblist; + if (! compat(7)) { + @liblist=map { "-e$_" } @lib_files; + } + # -I is used rather than using dpkg-gensymbols + # own search for symbols files, since that search + # is not 100% compatible with debhelper. (For example, + # this supports --ignore being used.) + doit("dpkg-gensymbols", "-p$package", "-I$symbols", + "-P$tmp", + @liblist, + @{$dh{U_PARAMS}}); + if (-s "$tmp/DEBIAN/symbols" == 0) { + doit("rm", "-f", "$tmp/DEBIAN/symbols"); + } + } + if ($is_multiarch) { + addsubstvar($package, "misc:Pre-Depends", "multiarch-support"); } } =head1 SEE ALSO -L +L This program is a part of debhelper.