chiark - git - mdw - dpkg/blob - man/deb-shlibs.man

   1 .\" dpkg manual page - deb-shlibs(5)
   2 .\"
   3 .\" Copyright © 1996 Michael Shields <shields@crosslink.net>
   4 .\" Copyright © 2008 Zack Weinberg <zackw@panix.com>
   5 .\"
   6 .\" This is free software; you can redistribute it and/or modify
   7 .\" it under the terms of the GNU General Public License as published by
   8 .\" the Free Software Foundation; either version 2 of the License, or
   9 .\" (at your option) any later version.
  10 .\"
  11 .\" This is distributed in the hope that it will be useful,
  12 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 .\" GNU General Public License for more details.
  15 .\"
  16 .\" You should have received a copy of the GNU General Public License
  17 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  18 .
  19 .TH deb\-shlibs 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
  20 .nh
  21 .SH NAME
  22 deb\-shlibs \- Debian shared library information file
  23 .
  24 .SH DESCRIPTION
  25 .PP
  26 .B shlibs
  27 files map shared library names and versions
  28 .RI ( sonames )
  29 to dependencies suitable for a package control file.  There is one
  30 entry per line. Blank lines are \fBnot\fP allowed.  Lines beginning
  31 with an \fB#\fP character are considered commentary, and are ignored.
  32 All other lines must have the format
  33 .IP
  34 .RI [ type\fB:\fP ]
  35 .I library
  36 .I version
  37 .I dependencies
  38 .PP
  39 The \fIlibrary\fP and \fIversion\fP fields are whitespace-delimited,
  40 but the \fIdependencies\fP field extends to the end of the line.  The
  41 \fItype\fP field is optional and normally not needed.
  42 .PP
  43 The \fIdependencies\fP field has the same syntax as the \fBDepends\fP
  44 field in a binary control file, see \fBdeb\-control\fP(5).
  45 .
  46 .SH EXAMPLES
  47 .PP
  48 The
  49 .B shlibs
  50 file for a typical library package, named
  51 .IR libcrunch1 ,
  52 that provides one library whose soname is
  53 .IR libcrunch.so.1 ,
  54 might read
  55 .IP
  56 libcrunch 1 libcrunch1 (>= 1.2-1)
  57 .PP
  58 The \fIdependencies\fP
  59 must mention the most recent version of the package that added new
  60 symbols to the library: in the above example, new symbols were added to
  61 version 1.2 of
  62 .IR libcrunch .
  63 This is not the only reason the dependencies might need to be
  64 tightened.
  65 .
  66 .SH SEE ALSO
  67 .BR deb\-control (5),
  68 .BR dpkg\-shlibdeps (1),
  69 .BR deb\-symbols (5).