NOME

       deb-symbols - ficheiro de informação de biblioteca partilhada extensiva de Debian

SINOPSE

       DEBIAN/symbols

DESCRIÇÃO

       Os ficheiros symbol são enviados em pacotes binários Debian, e o seu formato é um sub-
       conjunto dos ficheiros symbol modelo usados por dpkg-gensymbols(1)  em pacotes fonte
       Debian.

       O formato para uma entrada de informação de dependência de biblioteca partilhada extensiva
       nestes ficheiros é:

        library-soname main-dependency-template
        [| alternative-dependency-template]
        [...]
        [* field-name: field-value]
        [...]
         symbol minimal-version [id-of-dependency-template]

       O library-soname é exactamente o valor do campo SONAME como exportado por objdump(1). Um
       dependency-template é uma dependência onde #MINVER# é substituída dinamicamente seja por
       uma verificação de versão tipo “(>= minimal-version)” ou por nada (se uma dependência
       isenta-de-versão for considerada suficiente).

       Cada symbol exportado (listado como name@version, com version sendo “Base” se a biblioteca
       for isenta-de-versão) estiver associado a um minimal-version do seu modelo de dependência
       (o modelo de dependência principal é sempre usado e irá acabar sendo combinado com o
       modelo de dependência referenciado por id-of-dependency-template se presente). O primeiro
       modelo de dependência alternativa é numerado 1, o segundo 2, etc. Cada coluna é separada
       por exactamente um único espaço em branco.

       Cada entrada para uma biblioteca pode também ter alguns campos de meta-informação. Esses
       campos são armazenados em linhas que começam com um asterisco. Actualmente, os únicos
       campos válidos são:

       Build-Depends-Package
           Indica que o nome do pacote “-dev” associado a um binário associado à biblioteca e é
           usado por dpkg-shlibdeps para certificar que a dependência gerada é pelo menos tão
           rigorosa como a dependência de compilação correspondente (desde dpkg 1.14.13).

       Build-Depends-Packages
           O mesmo que Build-Depends-Package mas aceita uma lista separada por virgulas de nomes
           de pacotes (desde dpkg 1.20.0). Este campo irá sobrepor qualquer campo Build-Depends-
           Package presente, e é maioritariamente útil com pacotes “-dev” e meta-pacotes
           dependendo destes, digamos para um período de transição.

       Allow-Internal-Symbol-Groups
           Indica que grupos de símbolos internos deverão ser ignorados, como uma lista separada
           por espaços em branco, para que os símbolos contidos nesses grupos sejam incluídos no
           ficheiro resultante (desde dpkg 1.20.1). Isto só deve ser necessário para pacotes
           ferramenta-cadeia que providenciem esses símbolos internos. Os grupos disponíveis são
           dependentes do sistema, para ELF e sistemas baseados em GNU estes são aeabi e gomp.

       Ignore-Blacklist-Groups
           Um alias descontinuado para Allow-Internal-Symbol-Groups (desde dpkg 1.20.1, suportado
           desde dpkg 1.17.6).

EXEMPLOS

   Ficheiro symbols simples
        libftp.so.3 libftp3 #MINVER#
         DefaultNetbuf@Base 3.1-1-6
         FtpAccess@Base 3.1-1-6
         [...]

   Ficheiro symbols avançado
        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
         [...]

VEJA TAMBÉM

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

TRADUÇÃO

       Américo Monteiro

       Se encontrar algum erro na tradução deste documento, por favor comunique para Américo
       Monteiro <a_monteiro@gmx.com>.