1deb-symbols(5)                    dpkg suite                    deb-symbols(5)
2
3
4

NAME

6       deb-symbols - Debian's extended shared library information file
7

SYNOPSIS

9       symbols
10

DESCRIPTION

12       The  symbol files are shipped in Debian binary packages, and its format
13       is a subset of the template symbol files used by dpkg-gensymbols(1)  in
14       Debian source packages.
15
16       The  format for an extended shared library dependency information entry
17       in these files is:
18
19       library-soname main-dependency-template
20       [| alternative-dependency-template]
21       [...]
22       [* field-name: field-value]
23       [...]
24        symbol minimal-version [id-of-dependency-template]
25
26       The library-soname is exactly the value of the SONAME field as exported
27       by  objdump(1). A dependency-template is a dependency where #MINVER# is
28       dynamically replaced either by  a  version  check  like  “(>=  minimal-
29       version)”  or  by  nothing  (if  an  unversioned  dependency  is deemed
30       sufficient).
31
32       Each exported symbol (listed as name@version, with version being “Base”
33       if  the library is not versioned) is associated to a minimal-version of
34       its dependency template (the main dependency template  is  always  used
35       and  will end up being combined with the dependency template referenced
36       by  id-of-dependency-template  if  present).  The   first   alternative
37       dependency template is numbered 1, the second one 2, etc.
38
39       Each entry for a library can also have some fields of meta-information.
40       Those fields are stored on lines starting with an asterisk.  Currently,
41       the only valid fields are:
42
43       Build-Depends-Package
44              It  indicates  the  name of the “-dev” package associated to the
45              library and is used by dpkg-shlibdeps  to  make  sure  that  the
46              dependency  generated is at least as strict as the corresponding
47              build dependency (since dpkg 1.14.13).
48
49       Ignore-Blacklist-Groups
50              It indicates what blacklist  groups  should  be  ignored,  as  a
51              whitespace  separated  list,  so  that  the symbols contained in
52              those groups  get  included  in  the  output  file  (since  dpkg
53              1.17.6).   This  should only be necessary for toolchain packages
54              providing those blacklisted symbols. The  available  groups  are
55              system  dependent, for ELF and GNU-based systems these are aeabi
56              and gomp.
57

EXAMPLES

59   Simple symbols file
60       libftp.so.3 libftp3 #MINVER#
61        DefaultNetbuf@Base 3.1-1-6
62        FtpAccess@Base 3.1-1-6
63        [...]
64
65   Advanced symbols file
66       libGL.so.1 libgl1
67       | libgl1-mesa-glx #MINVER#
68       * Build-Depends-Package: libgl1-mesa-dev
69        publicGlSymbol@Base 6.3-1
70        [...]
71        implementationSpecificSymbol@Base 6.5.2-7 1
72        [...]
73

SEE ALSO

75       https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps
76       dpkg-shlibdeps(1), dpkg-gensymbols(1).
77
78
79
801.18.25                           2018-06-26                    deb-symbols(5)
Impressum