deb-symbols

Section: dpkg suite (5)
Updated: 1970-01-01
Page Index

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).

Each exported symbol (listed as name@version, with version being "Base" if the library is not versioned) is associated to a minimal-version of its dependency template (the main dependency template is always used and will end up being combined with the dependency template referenced by id-of-dependency-template if present). The first alternative dependency template is numbered 1, the second one 2, etc. Each column is separated by exactly a single whitespace.

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