1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
*****************************************************
* GENERATED FILE, DO NOT EDIT *
* THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
*****************************************************
This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.
In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.
=encoding UTF-8
=head1 NOME
deb-symbols - ficheiro de informação de biblioteca partilhada extensiva de
Debian
=head1 SINOPSE
B<DEBIAN/symbols>
=head1 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
B<dpkg-gensymbols>(1) em pacotes fonte Debian.
O formato para uma entrada de informação de dependência de biblioteca
partilhada extensiva nestes ficheiros é:
Z<>
I<library-soname main-dependency-template>
[| I<alternative-dependency-template>]
[...]
[* I<field-name>: I<field-value>]
[...]
I<symbol> I<minimal-version> [I<id-of-dependency-template>]
O I<library-soname> é exactamente o valor do campo SONAME como exportado por
B<objdump>(1). Um I<dependency-template> é uma dependência onde I<#MINVER#>
é substituída dinamicamente seja por uma verificação de versão tipo “(E<gt>=
I<minimal-version>)” ou por nada (se uma dependência isenta-de-versão for
considerada suficiente).
Cada I<symbol> exportado (listado como I<name>@I<version>, com I<version>
sendo “Base” se a biblioteca for isenta-de-versão) estiver associado a um
I<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 I<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:
=over
=item B<Build-Depends-Package>
Indica que o nome do pacote “-dev” associado a um binário associado à
biblioteca e é usado por B<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).
=item B<Build-Depends-Packages>
O mesmo que B<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 B<Build-Depends-Package> presente, e é maioritariamente útil
com pacotes “-dev” e meta-pacotes dependendo destes, digamos para um período
de transição.
=item B<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 B<aeabi> e B<gomp>.
=item B<Ignore-Blacklist-Groups>
Um alias descontinuado para B<Allow-Internal-Symbol-Groups> (desde dpkg
1.20.1, suportado desde dpkg 1.17.6).
=back
=head1 EXEMPLOS
=head2 Ficheiro symbols simples
libftp.so.3 libftp3 #MINVER#
DefaultNetbuf@Base 3.1-1-6
FtpAccess@Base 3.1-1-6
[...]
=head2 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
[...]
=head1 VEJA TAMBÉM
L<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>,
B<dpkg-shlibdeps>(1), B<dpkg-gensymbols>(1).
=head1 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>.
|
