1deb-symbols(5) dpkg suite deb-symbols(5)
2
3
4
6 deb-symbols - Debian's extended shared library information file
7
9 symbols
10
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
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
75 https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps
76 dpkg-shlibdeps(1), dpkg-gensymbols(1).
77
78
79
801.19.7 2019-06-03 deb-symbols(5)