NAAM

       deb-symbols - Informatiebestand over Debian's uitgebreide gedeelde bibliotheek

OVERZICHT

       DEBIAN/symbols

BESCHRIJVING

       De symboolbestanden worden meegeleverd met Debian binaire pakketten en de indeling ervan maakt gebruik
       van deelaspecten van de sjabloonsymboolbestanden die door dpkg-gensymbols(1) in Debian broncodepakketten
       gebruikt worden.

       In deze bestanden is de indeling van een item met informatie over een afhankelijkheid van de uitgebreide
       gedeelde bibliotheek als volgt:

        bibliotheek-soname hoofd-afhankelijkheidssjabloon
        [| alternatief-afhankelijkheidssjabloon]
        [...]
        [* veld-name: veld-waarde]
        [...]
         symbool minimale-versie [id-van-vereiste-sjabloon]

       De bibliotheeksoname is exact de waarde van het veld SONAME zoals die door objdump(1) geëxporteerd wordt.
       Een afhankelijkheidssjabloon is een afhankelijkheid waarbij #MINVER# dynamisch vervangen wordt door ofwel
       een versietoets zoals “(>= minimale-versie)” ofwel door niets (indien een versieloze afhankelijkheid
       voldoende geacht wordt).

       Elk geëxporteerd symbool (vermeld als naam@versie, waarbij versie “Base” is als het een versieloze
       bibliotheek betreft) is geassocieerd met een minimale-versie van zijn afhankelijkheidssjabloon (het
       hoofdafhankelijkheidssjabloon wordt altijd gebruikt en wordt uiteindelijk gecombineerd met het
       afhankelijkheidssjabloon waarnaar verwezen wordt door id-van-afhankelijkheidssjabloon als dat voorhanden
       is). Het eerste alternatieve afhankelijkheidssjabloon krijgt het nummer 1, het tweede 2 enzovoort. Elke
       kolom wordt door exact één witruimte gescheiden.

       Elk item over een bibliotheek kan ook velden met meta-informatie bevatten. Die velden worden opgeslagen
       in regels die beginnen met een asterisk. Momenteel mogen enkel de volgende velden gebruikt worden:

       Build-Depends-Package
           Dit geeft de naam op van het “-dev”-pakket dat geassocieerd is met de bibliotheek en het wordt
           gebruikt door dpkg-shlibdeps om er zeker van te zijn dat de gegenereerde afhankelijkheid minstens
           even strikt is als de overeenkomstige bouw-afhankelijkheid (sinds dpkg 1.14.13)

       Build-Depends-Packages
           Hetzelfde als Build-Depends-Package, maar aanvaardt een door komma's gescheiden lijst van pakketnamen
           (sins dpkg 1.20.0). Dit veld zal eventuele bestaande Build-Depends-Package-velden overschrijven en is
           vooral nuttig voor “-dev”-pakketten en ervan afhankelijke metapakketten, bijvoorbeeld voor een
           transitieperiode.

       Allow-Internal-Symbol-Groups
           Dit vermeldt in een lijst met witruimte als scheidingsteken welke interne symbolengroepen genegeerd
           moeten worden, zodat de symbolen uit deze groepen mee opgenomen worden in het uitvoerbestand (sinds
           dpkg 1.20.1). Dit zou enkel noodzakelijk moeten zijn voor pakketten uit de gereedschapskist die deze
           interne symbolen ter beschikking stellen. De beschikbare groepen zijn systeemafhankelijk en voor op
           ELF en op GNU gebaseerde systemen zijn dat aeabi en gomp.

       Ignore-Blacklist-Groups
           Een verouderde alias voor Allow-Internal-Symbol-Groups (sins dpkg 1.20.1, ondersteund sinds dpkg
           1.17.6).

VOORBEELDEN

   Eenvoudig symboolbestand
        libftp.so.3 libftp3 #MINVER#
         DefaultNetbuf@Base 3.1-1-6
         FtpAccess@Base 3.1-1-6
         [...]

   Geavanceerd symboolbestand
        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
         [...]

ZIE OOK

       <https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>, dpkg-shlibdeps(1), dpkg-gensymbols(1).