summaryrefslogtreecommitdiffstats
path: root/man/deb-shlibs.man
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-06 00:45:20 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-06 00:45:20 +0000
commit9a08cbfcc1ef900a04580f35afe2a4592d7d6030 (patch)
tree004cc7027bca2f2c0bcb5806527c8e0c48df2d6e /man/deb-shlibs.man
parentInitial commit. (diff)
downloaddpkg-upstream/1.19.8.tar.xz
dpkg-upstream/1.19.8.zip
Adding upstream version 1.19.8.upstream/1.19.8upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man/deb-shlibs.man')
-rw-r--r--man/deb-shlibs.man69
1 files changed, 69 insertions, 0 deletions
diff --git a/man/deb-shlibs.man b/man/deb-shlibs.man
new file mode 100644
index 0000000..223cd44
--- /dev/null
+++ b/man/deb-shlibs.man
@@ -0,0 +1,69 @@
+.\" 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/>.
+.
+.TH deb\-shlibs 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
+.nh
+.SH NAME
+deb\-shlibs \- Debian shared library information file
+.
+.SH DESCRIPTION
+.PP
+.B shlibs
+files map shared library names and versions
+.RI ( sonames )
+to dependencies suitable for a package control file. There is one
+entry per line. Blank lines are \fBnot\fP allowed. Lines beginning
+with an \fB#\fP character are considered commentary, and are ignored.
+All other lines must have the format
+.IP
+.RI [ type\fB:\fP ]
+.I library
+.I version
+.I dependencies
+.PP
+The \fIlibrary\fP and \fIversion\fP fields are whitespace-delimited,
+but the \fIdependencies\fP field extends to the end of the line. The
+\fItype\fP field is optional and normally not needed.
+.PP
+The \fIdependencies\fP field has the same syntax as the \fBDepends\fP
+field in a binary control file, see \fBdeb\-control\fP(5).
+.
+.SH EXAMPLES
+.PP
+The
+.B shlibs
+file for a typical library package, named
+.IR libcrunch1 ,
+that provides one library whose soname is
+.IR libcrunch.so.1 ,
+might read
+.IP
+libcrunch 1 libcrunch1 (>= 1.2-1)
+.PP
+The \fIdependencies\fP
+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
+.IR libcrunch .
+This is not the only reason the dependencies might need to be
+tightened.
+.
+.SH SEE ALSO
+.BR deb\-control (5),
+.BR dpkg\-shlibdeps (1),
+.BR deb\-symbols (5).