~noskcaj/ubuntu/saucy/debhelper/saucy

« back to all changes in this revision

Viewing changes to dh_makeshlibs

  • Committer: Bazaar Package Importer
  • Author(s): أحمد المحمودي (Ahmed El-Mahmoudy)
  • Date: 2011-02-07 17:16:49 UTC
  • mfrom: (1.4.21 sid)
  • Revision ID: james.westby@ubuntu.com-20110207171649-v8k6uowavom83cxt
Tags: 8.1.0ubuntu1
* Merge with Debian (LP: #714705); remaining changes:
  - dh_installinit: Add --upstart-only and --onlyscripts-upstart modes.
  - Add various autoscripts for above: postinst-upstart,
    postinst-upstart-replace, postinst-upstart-restart,
    prerm-upstart, prerm-upstart-norestart, preinst-removeconffile.
  - dh_installudev: Change default init.d symlink priority to 40.
  - dh_installchangelogs: Do not install upstream changelog in compat level
    7. This floods packages with huge upstream changelogs which take
    precious CD space.
  - dh_strip, dh_makeshlibs: use triplet-objdump, triplet-objcopy and
    triplet-strip from cross-binutils when cross-compiling; Debian #412118.
  - add dh_apparmor and autoscripts
  - debian/rules: override build target to set executable bit for
    dh_apparmor before actually running dh build, that is in order to get
    the manpage built for dh_apparmor.

Show diffs side-by-side

added added

removed removed

Lines of Context:
15
15
 
16
16
=head1 DESCRIPTION
17
17
 
18
 
dh_makeshlibs is a debhelper program that automatically scans for shared
 
18
B<dh_makeshlibs> is a debhelper program that automatically scans for shared
19
19
libraries, and generates a shlibs file for the libraries it finds.
20
20
 
21
 
It also adds a call to ldconfig in the postinst and postrm scripts (in
 
21
It also adds a call to ldconfig in the F<postinst> and F<postrm> scripts (in
22
22
v3 mode and above only) to any packages in which it finds shared libraries.
23
23
 
24
24
=head1 FILES
41
41
 
42
42
=item B<-m>I<major>, B<--major=>I<major>
43
43
 
44
 
Instead of trying to guess the major number of the library with objdump,
 
44
Instead of trying to guess the major number of the library with /postobjdump,
45
45
use the major number specified after the -m parameter. This is much less
46
46
useful than it used to be, back in the bad old days when this program
47
47
looked at library filenames rather than using objdump.
53
53
By default, the shlibs file generated by this program does not make packages
54
54
depend on any particular version of the package containing the shared
55
55
library. It may be necessary for you to add some version dependancy
56
 
information to the shlibs file. If -V is specified with no dependency
 
56
information to the shlibs file. If B<-V> is specified with no dependency
57
57
information, the current upstream version of the package is plugged into a
58
 
dependency that looks like "packagename (>= packageversion)". Note that in
59
 
debhelper compatibility levels before v4, the debian part of the package
60
 
version number is also included. If -V is specified with parameters, the
 
58
dependency that looks like "I<packagename> B<(=E<gt>> I<packageversion>B<)>". Note that in
 
59
debhelper compatibility levels before v4, the Debian part of the package
 
60
version number is also included. If B<-V> is specified with parameters, the
61
61
parameters can be used to specify the exact dependency information needed
62
62
(be sure to include the package name).
63
63
 
64
 
Beware of using -V without any parameters; this is a conservative setting
 
64
Beware of using B<-V> without any parameters; this is a conservative setting
65
65
that always ensures that other packages' shared library dependencies are at
66
66
least as tight as they need to be (unless your library is prone to changing
67
67
ABI without updating the upstream version number), so that if the
71
71
 
72
72
=item B<-n>, B<--noscripts>
73
73
 
74
 
Do not modify postinst/postrm scripts.
 
74
Do not modify F<postinst>/F<postrm> scripts.
75
75
 
76
76
=item B<-X>I<item>, B<--exclude=>I<item>
77
77
 
78
 
Exclude files that contain "item" anywhere in their filename or directory 
 
78
Exclude files that contain I<item> anywhere in their filename or directory 
79
79
from being treated as shared libraries.
80
80
 
81
81
=item B<--add-udeb=>I<udeb>
82
82
 
83
 
Create an additional line for udebs in the shlibs file and use "udeb" as the
 
83
Create an additional line for udebs in the shlibs file and use I<udeb> as the
84
84
package name for udebs to depend on instead of the regular library package.
85
85
 
86
86
=item B<--> I<params>
87
87
 
88
 
Pass "params" to L<dpkg-gensymbols(1)>.
 
88
Pass I<params> to L<dpkg-gensymbols(1)>.
89
89
 
90
90
=back
91
91
 
93
93
 
94
94
=over 4
95
95
 
96
 
=item dh_makeshlibs
 
96
=item B<dh_makeshlibs>
97
97
 
98
 
Assuming this is a package named libfoobar1, generates a shlibs file that
 
98
Assuming this is a package named F<libfoobar1>, generates a shlibs file that
99
99
looks something like:
100
100
 libfoobar 1 libfoobar1
101
101
 
102
 
=item dh_makeshlibs -V
 
102
=item B<dh_makeshlibs -V>
103
103
 
104
104
Assuming the current version of the package is 1.1-3, generates a shlibs
105
105
file that looks something like:
106
106
 libfoobar 1 libfoobar1 (>= 1.1)
107
107
 
108
 
=item dh_makeshlibs -V 'libfoobar1 (>= 1.0)'
 
108
=item B<dh_makeshlibs -V 'libfoobar1 (E<gt>= 1.0)'>
109
109
 
110
110
Generates a shlibs file that looks something like:
111
111
  libfoobar 1 libfoobar1 (>= 1.0)