1deb-symbols(5)                  dpkg utilities                  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  format for an extended shared library dependency information entry
13       in these files is:
14
15       <library soname> <main dependency template>
16       [ | <alternative dependency template> ]
17       [ ... ]
18       [ * <field-name>: <field value> ]
19       [ ... ]
20        <symbol> <minimal version>[ <id of dependency template> ]
21
22       The library soname is exactly the value of the SONAME field as exported
23       by  objdump(1). A dependency template is a dependency where #MINVER# is
24       dynamically replaced either by a version check like "(>=  minimal  ver‐
25       sion)"  or  by  nothing  (if an unversioned dependency is deemed suffi‐
26       cient).
27
28       Each exported symbol (listed as name@version, with version being "Base"
29       if  the library is not versioned) is associated to a minimal version of
30       its dependency template (the main dependency template is used if id  of
31       dependency  template  is not present). The first alternative dependency
32       template is numbered 1, the second one 2, etc.
33
34       Each entry for a library can also have some fields of meta-information.
35       Those  fields are stored on lines starting with an asterisk. Currently,
36       the only valid field is Build-Depends-Package, it indicates the name of
37       the "-dev" package associated to the library and is used by dpkg-shlib‐
38       deps to make sure that the dependency generated is at least  as  strict
39       as the corresponding build dependency.
40

EXAMPLES

42   Simple symbols file
43       libftp.so.3 libftp3 #MINVER#
44        DefaultNetbuf@Base 3.1-1-6
45        FtpAccess@Base 3.1-1-6
46        [...]
47
48   Advanced symbols file
49       libGL.so.1 libgl1
50       | libgl1-mesa-glx #MINVER#
51       * Build-Depends-Package: libgl1-mesa-dev
52        publicGlSymbol@Base 6.3-1
53        [...]
54        implementationSpecificSymbol@Base 6.5.2-7 1
55        [...]
56

SEE ALSO

58       http://wiki.debian.org/Projects/ImprovedDpkgShlibdeps
59       dpkg-shlibdeps(1), dpkg-gensymbols(1).
60
61
62
63Debian Project                    2007-07-16                    deb-symbols(5)
Impressum