=head1 NAME
-dh_makeshlibs - automatically create shlibs file
+dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols
=cut
=head1 SYNOPSIS
-B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] [B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>]
+B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] [B<-V>I<[dependencies]>] [B<-n>] [B<-X>I<item>] [S<B<--> I<params>>]
=head1 DESCRIPTION
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
-V3 mode and above only) to any packages which it finds shared libraries in.
+V3 mode and above only) to any packages in which it finds shared libraries.
+
+=head1 FILES
+
+=over 4
+
+=item debian/I<package>.symbols
+
+=item debian/I<package>.symbols.I<arch>
+
+These symbols files, if present, are passed to L<dpkg-gensymbols(1)> to
+be processed and installed. Use the I<arch> specific names if you need
+to provide different symbols files for different architectures.
+
+=back
=head1 OPTIONS
Exclude files that contain "item" anywhere in their filename or directory
from being treated as shared libraries.
+=item B<--add-udeb=>I<udeb>
+
+Create an additional line for udebs in the shlibs file and use "udeb" as the
+package name for udebs to depend on instead of the regular library package.
+
+=item B<--> I<params>
+
+Pass "params" to L<dpkg-gensymbols(1)>.
+
=back
=head1 EXAMPLES
=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},
+});
foreach my $package (@{$dh{DOPACKAGES}}) {
next if is_udeb($package);
# because only if we can get a library name and a major number from
# objdump is anything actually added.
my $exclude='';
+ my @udeb_lines;
if (defined($dh{EXCLUDE_FIND}) && $dh{EXCLUDE_FIND} ne '') {
$exclude="! \\( $dh{EXCLUDE_FIND} \\) ";
}
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");
doit("chmod",644,"$tmp/DEBIAN/shlibs");
doit("chown","0:0","$tmp/DEBIAN/shlibs");
}
+
+ # dpkg-gensymbols files
+ my $symbols=pkgfile($package, "symbols");
+ if (-e $symbols) {
+ # -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", @{$dh{U_PARAMS}});
+ if (-s "$tmp/DEBIAN/symbols" == 0) {
+ doit("rm", "-f", "$tmp/DEBIAN/symbols");
+ }
+ }
}
=head1 SEE ALSO