deb-shlibs.5 2.1 KB

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