deb-shlibs(5) — Linux manual page


deb-shlibs(5)                  dpkg suite                  deb-shlibs(5)

NAME         top

       deb-shlibs - Debian shared library information file

SYNOPSIS         top

       debian/shlibs, debian/binary-name.shlibs, DEBIAN/shlibs

DESCRIPTION         top

       shlibs files map shared library names and versions (SONAMEs) to
       dependencies suitable for a package control file.  There is one
       entry per line. Blank lines are not allowed.  Lines beginning
       with a # character are considered commentary, and are ignored.
       All other lines must have the format:

           [type:] library version dependencies

       The library and version fields are whitespace-delimited, but the
       dependencies field extends to the end of the line.  The type
       field is optional and normally not needed.

       The dependencies field has the same syntax as the Depends field
       in a binary control file, see deb-control(5).

SONAME FORMATS         top

       The SONAME formats supported are:




       where name is usually prefixed by 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

EXAMPLES         top

       The shlibs file for a typical library package, named libcrunch1,
       that provides one library whose SONAME is, might

        libcrunch 1 libcrunch1 (>= 1.2-1)

       The 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 libcrunch.
       This is not the only reason the dependencies might need to be

SEE ALSO         top

       deb-control(5), dpkg-shlibdeps(1), deb-symbols(5).

COLOPHON         top

       This page is part of the dpkg (Debian Package Manager) project.
       Information about the project can be found at 
       ⟨⟩.  If you have a bug report
       for this manual page, see
       ⟨⟩.  This
       page was obtained from the project's upstream Git repository ⟨git
       clone⟩ on 2023-06-23.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-05-29.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

1.21.20-209-g3026e             2023-02-07                  deb-shlibs(5)

Pages that refer to this page: dpkg-shlibdeps(1)deb(5)