1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
# dpkg manual page - deb-shlibs(5)
#
# Copyright © 1996 Michael Shields <shields@crosslink.net>
# Copyright © 2008 Zack Weinberg <zackw@panix.com>
#
# This is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <https://www.gnu.org/licenses/>.
=encoding utf8
=head1 NAME
deb-shlibs - Debian shared library information file
=head1 SYNOPSIS
B<debian/shlibs>, B<debian/>I<binary-name>B<.shlibs>, B<DEBIAN/shlibs>
=head1 DESCRIPTION
B<shlibs>
files map shared library names and versions
(I<SONAMEs>)
to dependencies suitable for a package control file.
There is one entry per line.
Blank lines are B<not> allowed.
Lines beginning
with a B<#> character are considered commentary, and are ignored.
All other lines must have the format:
=over
[I<type>B<:>]
I<library>
I<version>
I<dependencies>
=back
The I<library> and I<version> fields are whitespace-delimited,
but the I<dependencies> field extends to the end of the line.
The
I<type> field is optional and normally not needed.
The I<dependencies> field has the same syntax as the B<Depends>
field in a binary control file, see L<deb-control(5)>.
=head1 SONAME FORMATS
The SONAME formats supported are:
=over
I<name>.so.I<version>
=back
and
=over
I<name>-I<version>.so
=back
where I<name> is usually prefixed by B<lib>.
The former tends to be used by shared libraries with stable interfaces.
The latter by shared libraries with unstable interfaces, where the whole
version becomes part of the SONAME and needs to be specified in full
when linking against those libraries.
=head1 EXAMPLES
The
B<shlibs>
file for a typical library package, named
I<libcrunch1>,
that provides one library whose SONAME is
I<libcrunch.so.1>,
might read
=over
libcrunch 1 libcrunch1 (>= 1.2-1)
=back
The I<dependencies>
must mention the most recent version of the package that added new
symbols to the library: in the above example, new symbols were added to
version 1.2 of
I<libcrunch>.
This is not the only reason the dependencies might need to be
tightened.
=head1 SEE ALSO
L<deb-control(5)>,
L<deb-symbols(5)>,
L<dpkg-shlibdeps(1)>.
|
