summaryrefslogtreecommitdiffstats
path: root/man/deb-shlibs.pod
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 14:58:51 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 14:58:51 +0000
commitcbffab246997fb5a06211dfb706b54e5ae5bb59f (patch)
tree0573c5d96f58d74d76a49c0f2a70398e389a36d3 /man/deb-shlibs.pod
parentInitial commit. (diff)
downloaddpkg-cbffab246997fb5a06211dfb706b54e5ae5bb59f.tar.xz
dpkg-cbffab246997fb5a06211dfb706b54e5ae5bb59f.zip
Adding upstream version 1.21.22.upstream/1.21.22upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man/deb-shlibs.pod')
-rw-r--r--man/deb-shlibs.pod103
1 files changed, 103 insertions, 0 deletions
diff --git a/man/deb-shlibs.pod b/man/deb-shlibs.pod
new file mode 100644
index 0000000..433471c
--- /dev/null
+++ b/man/deb-shlibs.pod
@@ -0,0 +1,103 @@
+# 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 B<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>.
+
+=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
+
+B<deb-control>(5),
+B<dpkg-shlibdeps>(1),
+B<deb-symbols>(5).