{
    "mode": "man",
    "parameter": "deb-symbols",
    "section": "5",
    "url": "https://www.chedong.com/phpMan.php/man/deb-symbols/5/json",
    "generated": "2026-05-30T07:10:48Z",
    "synopsis": "",
    "sections": {
        "NAME": {
            "content": "deb-symbols - Debian's extended shared library information file\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "",
            "subsections": [
                {
                    "name": "DEBIAN/symbols",
                    "content": ""
                }
            ]
        },
        "DESCRIPTION": {
            "content": "The symbol files are shipped in Debian binary packages, and its format is a subset of the\ntemplate symbol files used by dpkg-gensymbols(1) in Debian source packages.\n\nThe format for an extended shared library dependency information entry in these files is:\n\nlibrary-soname main-dependency-template\n[| alternative-dependency-template]\n[...]\n[* field-name: field-value]\n[...]\nsymbol minimal-version [id-of-dependency-template]\n\nThe library-soname is exactly the value of the SONAME field as exported by objdump(1). A\ndependency-template is a dependency where #MINVER# is dynamically replaced either by a\nversion check like “(>= minimal-version)” or by nothing (if an unversioned dependency is\ndeemed sufficient).\n\nEach exported symbol (listed as name@version, with version being “Base” if the library is not\nversioned) is associated to a minimal-version of its dependency template (the main dependency\ntemplate is always used and will end up being combined with the dependency template\nreferenced by id-of-dependency-template if present). The first alternative dependency\ntemplate is numbered 1, the second one 2, etc.  Each column is separated by exactly a single\nwhitespace.\n\nEach entry for a library can also have some fields of meta-information.  Those fields are\nstored on lines starting with an asterisk. Currently, the only valid fields are:\n",
            "subsections": [
                {
                    "name": "Build-Depends-Package",
                    "content": "It indicates the name of the “-dev” package associated to the library and is used by\ndpkg-shlibdeps to make sure that the dependency generated is at least as strict as the\ncorresponding build dependency (since dpkg 1.14.13).\n"
                },
                {
                    "name": "Build-Depends-Packages",
                    "content": "The same as Build-Depends-Package but accepts a comma-separated list of package names\n(since dpkg 1.20.0).  This field will override any Build-Depends-Package field present,\nand is mostly useful with “-dev” packages and metapackages depending on these, say for a\ntransition period.\n"
                },
                {
                    "name": "Allow-Internal-Symbol-Groups",
                    "content": "It indicates what internal symbol groups should be ignored, as a whitespace separated\nlist, so that the symbols contained in those groups get included in the output file\n(since dpkg 1.20.1).  This should only be necessary for toolchain packages providing\nthose internal symbols. The available groups are system dependent, for ELF and GNU-based\nsystems these are aeabi and gomp.\n"
                },
                {
                    "name": "Ignore-Blacklist-Groups",
                    "content": "A deprecated alias for Allow-Internal-Symbol-Groups (since dpkg 1.20.1, supported since\ndpkg 1.17.6).\n"
                }
            ]
        },
        "EXAMPLES": {
            "content": "",
            "subsections": [
                {
                    "name": "Simple symbols file",
                    "content": "libftp.so.3 libftp3 #MINVER#\nDefaultNetbuf@Base 3.1-1-6\nFtpAccess@Base 3.1-1-6\n[...]\n"
                },
                {
                    "name": "Advanced symbols file",
                    "content": "libGL.so.1 libgl1\n| libgl1-mesa-glx #MINVER#\n* Build-Depends-Package: libgl1-mesa-dev\npublicGlSymbol@Base 6.3-1\n[...]\nimplementationSpecificSymbol@Base 6.5.2-7 1\n[...]\n"
                }
            ]
        },
        "SEE ALSO": {
            "content": "<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>, dpkg-shlibdeps(1), dpkg-\ngensymbols(1).\n\n\n\n1.21.1                                       2025-09-09                               deb-symbols(5)",
            "subsections": []
        }
    },
    "summary": "deb-symbols - Debian's extended shared library information file",
    "flags": [],
    "examples": [
        "libftp.so.3 libftp3 #MINVER#",
        "DefaultNetbuf@Base 3.1-1-6",
        "FtpAccess@Base 3.1-1-6",
        "[...]",
        "libGL.so.1 libgl1",
        "| libgl1-mesa-glx #MINVER#",
        "* Build-Depends-Package: libgl1-mesa-dev",
        "publicGlSymbol@Base 6.3-1",
        "[...]",
        "implementationSpecificSymbol@Base 6.5.2-7 1",
        "[...]"
    ],
    "see_also": [
        {
            "name": "dpkg-shlibdeps",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/dpkg-shlibdeps/1/json"
        },
        {
            "name": "gensymbols",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/gensymbols/1/json"
        }
    ]
}