summaryrefslogtreecommitdiffstats
path: root/man/pt/deb-symbols.pod
blob: 59502dc10de83a3b800160e32b55fe6f835bb622 (plain)
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
        *****************************************************
        *           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 RESUMO

B<DEBIAN/symbols>

=head1 DESCRIÇÃO

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

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

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

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

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>, L<deb-src-symbols(5)>, L<dpkg-shlibdeps(1)>, L<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>.