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)
108 "m=s", => \$dh{M_PARAMS},
109 "major=s" => \$dh{M_PARAMS},
110 "version-info:s" => \$dh{V_FLAG},
111 "add-udeb=s" => \$dh{SHLIBS_UDEB},
114 foreach my $package (@{$dh{DOPACKAGES}}) {
115 next if is_udeb($package);
117 my $tmp=tmpdir($package);
120 my $need_ldconfig = 0;
122 doit("rm", "-f", "$tmp/DEBIAN/shlibs");
124 # So, we look for files or links to existing files with names that
125 # match "*.so*". Matching *.so.* is not good enough because of
126 # broken crap like db3. And we only look at real files not
127 # symlinks, so we don't accidentually add shlibs data to -dev
128 # packages. This may have a few false positives, which is ok,
129 # because only if we can get a library name and a major number from
130 # objdump is anything actually added.
133 if (defined($dh{EXCLUDE_FIND}) && $dh{EXCLUDE_FIND} ne '') {
134 $exclude="! \\( $dh{EXCLUDE_FIND} \\) ";
136 open (FIND, "find $tmp -type f \\( -name '*.so' -or -name '*.so.*' \\) $exclude |");
138 my ($library, $major);
139 my $objdump=`objdump -p $_`;
140 if ($objdump=~m/\s+SONAME\s+(.+)\.so\.(.+)/) {
141 # proper soname format
145 elsif ($objdump=~m/\s+SONAME\s+(.+)-(.+)\.so/) {
146 # idiotic crap soname format
151 if (defined($dh{M_PARAMS}) && $dh{M_PARAMS} ne '') {
152 $major=$dh{M_PARAMS};
155 if (! -d "$tmp/DEBIAN") {
156 doit("install","-d","$tmp/DEBIAN");
159 if ($dh{V_FLAG_SET}) {
160 if ($dh{V_FLAG} ne '') {
164 # Call isnative becuase it sets $dh{VERSION}
167 my $version = $dh{VERSION};
168 # Old compatibility levels include the
169 # debian revision, while new do not.
171 # Remove debian version, if any.
172 $version =~ s/-[^-]+$//;
174 $deps="$package (>= $version)";
177 if (defined($library) && defined($major) && defined($deps) &&
178 $library ne '' && $major ne '' && $deps ne '') {
180 # Prevent duplicate lines from entering the file.
181 my $line="$library $major $deps";
182 if (! $seen{$line}) {
184 complex_doit("echo '$line' >>$tmp/DEBIAN/shlibs");
185 if (defined($dh{SHLIBS_UDEB}) && $dh{SHLIBS_UDEB} ne '') {
186 my $udeb_deps = $deps;
187 $udeb_deps =~ s/\Q$package\E/$dh{SHLIBS_UDEB}/e;
188 $line="udeb: "."$library $major $udeb_deps";
189 push @udeb_lines, $line;
196 # Write udeb: lines last.
197 foreach (@udeb_lines) {
198 complex_doit("echo '$_' >>$tmp/DEBIAN/shlibs");
202 if (! compat(2) && ! $dh{NOSCRIPTS} && $need_ldconfig) {
203 autoscript($package,"postinst","postinst-makeshlibs");
204 autoscript($package,"postrm","postrm-makeshlibs");
207 if (-e "$tmp/DEBIAN/shlibs") {
208 doit("chmod",644,"$tmp/DEBIAN/shlibs");
209 doit("chown","0:0","$tmp/DEBIAN/shlibs");
212 # dpkg-gensymbols files
213 my $symbols=pkgfile($package, "symbols");
215 # -I is used rather than using dpkg-gensymbols
216 # own search for symbols files, since that search
217 # is not 100% compatible with debhelper. (For example,
218 # this supports --ignore being used.)
219 doit("dpkg-gensymbols", "-p$package", "-I$symbols",
220 "-P$tmp", @{$dh{U_PARAMS}});
221 if (-s "$tmp/DEBIAN/symbols" == 0) {
222 doit("rm", "-f", "$tmp/DEBIAN/symbols");
231 This program is a part of debhelper.
235 Joey Hess <joeyh@debian.org>