5 dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols
10 use Debian::Debhelper::Dh_Lib;
14 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>>]
18 dh_makeshlibs is a debhelper program that automatically scans for shared
19 libraries, and generates a shlibs file for the libraries it finds.
21 It also adds a call to ldconfig in the postinst and postrm scripts (in
22 V3 mode and above only) to any packages in which it finds shared libraries.
24 If a L<dpkg-gensymbols(1)> symbol file is found in debian/package.symbols
25 (or debian/package.symbols.arch), dpkg-gensymbols will be called
26 to process and install the symbols file.
32 =item B<-m>I<major>, B<--major=>I<major>
34 Instead of trying to guess the major number of the library with objdump,
35 use the major number specified after the -m parameter. This is much less
36 useful than it used to be, back in the bad old days when this program
37 looked at library filenames rather than using objdump.
39 =item B<-V>, B<-V>I<dependencies>
41 =item B<--version-info>, B<--version-info=>I<dependencies>
43 By default, the shlibs file generated by this program does not make packages
44 depend on any particular version of the package containing the shared
45 library. It may be necessary for you to add some version dependancy
46 information to the shlibs file. If -V is specified with no dependency
47 information, the current upstream version of the package is plugged into a
48 dependency that looks like "packagename (>= packageversion)". Note that in
49 debhelper compatibility levels before v4, the debian part of the package
50 version number is also included. If -V is specified with parameters, the
51 parameters can be used to specify the exact dependency information needed
52 (be sure to include the package name).
54 Beware of using -V without any parameters; this is a conservative setting
55 that always ensures that other packages' shared library dependencies are at
56 least as tight as they need to be (unless your library is prone to changing
57 ABI without updating the upstream version number), so that if the
58 maintainer screws up then they won't break. The flip side is that packages
59 might end up with dependencies that are too tight and so find it harder to
62 =item B<-n>, B<--noscripts>
64 Do not modify postinst/postrm scripts.
66 =item B<-X>I<item>, B<--exclude=>I<item>
68 Exclude files that contain "item" anywhere in their filename or directory
69 from being treated as shared libraries.
71 =item B<--add-udeb=>I<udeb>
73 Create an additional line for udebs in the shlibs file and use "udeb" as the
74 package name for udebs to depend on instead of the regular library package.
78 Pass "params" to L<dpkg-gensymbols(1)>.
88 Assuming this is a package named libfoobar1, generates a shlibs file that
90 libfoobar 1 libfoobar1
92 =item dh_makeshlibs -V
94 Assuming the current version of the package is 1.1-3, generates a shlibs
95 file that looks something like:
96 libfoobar 1 libfoobar1 (>= 1.1)
98 =item dh_makeshlibs -V 'libfoobar1 (>= 1.0)'
100 Generates a shlibs file that looks something like:
101 libfoobar 1 libfoobar1 (>= 1.0)
109 foreach my $package (@{$dh{DOPACKAGES}}) {
110 next if is_udeb($package);
112 my $tmp=tmpdir($package);
115 my $need_ldconfig = 0;
117 doit("rm", "-f", "$tmp/DEBIAN/shlibs");
119 # So, we look for files or links to existing files with names that
120 # match "*.so*". Matching *.so.* is not good enough because of
121 # broken crap like db3. And we only look at real files not
122 # symlinks, so we don't accidentually add shlibs data to -dev
123 # packages. This may have a few false positives, which is ok,
124 # because only if we can get a library name and a major number from
125 # objdump is anything actually added.
128 if (defined($dh{EXCLUDE_FIND}) && $dh{EXCLUDE_FIND} ne '') {
129 $exclude="! \\( $dh{EXCLUDE_FIND} \\) ";
131 open (FIND, "find $tmp -type f \\( -name '*.so' -or -name '*.so.*' \\) $exclude |");
133 my ($library, $major);
134 my $objdump=`objdump -p $_`;
135 if ($objdump=~m/\s+SONAME\s+(.+)\.so\.(.+)/) {
136 # proper soname format
140 elsif ($objdump=~m/\s+SONAME\s+(.+)-(.+)\.so/) {
141 # idiotic crap soname format
146 if (defined($dh{M_PARAMS}) && $dh{M_PARAMS} ne '') {
147 $major=$dh{M_PARAMS};
150 if (! -d "$tmp/DEBIAN") {
151 doit("install","-d","$tmp/DEBIAN");
154 if ($dh{V_FLAG_SET}) {
155 if ($dh{V_FLAG} ne '') {
159 # Call isnative becuase it sets $dh{VERSION}
162 my $version = $dh{VERSION};
163 # Old compatibility levels include the
164 # debian revision, while new do not.
166 # Remove debian version, if any.
167 $version =~ s/-[^-]+$//;
169 $deps="$package (>= $version)";
172 if (defined($library) && defined($major) && defined($deps) &&
173 $library ne '' && $major ne '' && $deps ne '') {
175 # Prevent duplicate lines from entering the file.
176 my $line="$library $major $deps";
177 if (! $seen{$line}) {
179 complex_doit("echo '$line' >>$tmp/DEBIAN/shlibs");
180 if (defined($dh{SHLIBS_UDEB}) && $dh{SHLIBS_UDEB} ne '') {
181 my $udeb_deps = $deps;
182 $udeb_deps =~ s/\Q$package\E/$dh{SHLIBS_UDEB}/e;
183 $line="udeb: "."$library $major $udeb_deps";
184 push @udeb_lines, $line;
191 # Write udeb: lines last.
192 foreach (@udeb_lines) {
193 complex_doit("echo '$_' >>$tmp/DEBIAN/shlibs");
197 if (! compat(2) && ! $dh{NOSCRIPTS} && $need_ldconfig) {
198 autoscript($package,"postinst","postinst-makeshlibs");
199 autoscript($package,"postrm","postrm-makeshlibs");
202 if (-e "$tmp/DEBIAN/shlibs") {
203 doit("chmod",644,"$tmp/DEBIAN/shlibs");
204 doit("chown","0:0","$tmp/DEBIAN/shlibs");
207 # dpkg-gensymbols files
208 my $symbols=pkgfile($package, "symbols");
210 # -I is used rather than using dpkg-gensymbols
211 # own search for symbols files, since that search
212 # is not 100% compatible with debhelper. (For example,
213 # this supports --ignore being used.)
214 doit("dpkg-gensymbols", "-p$package", "-I$symbols",
215 "-P$tmp", @{$dh{U_PARAMS}});
216 if (-s "$tmp/DEBIAN/symbols" == 0) {
217 doit("rm", "-f", "$tmp/DEBIAN/symbols");
226 This program is a part of debhelper.
230 Joey Hess <joeyh@debian.org>