NOME¶

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

RESUMO¶

DEBIAN/symbols

DESCRIÇÃO¶

The symbol files are shipped in Debian binary packages, and its format is a subset of the template symbol files used by dpkg-gensymbols(1) in Debian source packages, see deb-src-symbols(5).

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]

The library-soname is exactly the value of the SONAME field as exported by objdump(1). A dependency-template is a dependency where #MINVER# is dynamically replaced either by a version check like “(>= minimal-version)” or by nothing (if an unversioned dependency is deemed sufficient).

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¶

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

VEJA TAMBÉM¶

<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>, deb-src-symbols(5), 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>.