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
|
*****************************************************
* 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 NAAM
deb-symbols - Informatiebestand over Debian's uitgebreide gedeelde
bibliotheek
=head1 OVERZICHT
B<DEBIAN/symbols>
=head1 BESCHRIJVING
De symboolbestanden worden meegeleverd met Debian binaire pakketten en de
indeling ervan maakt gebruik van deelaspecten van de
sjabloonsymboolbestanden die door B<dpkg-gensymbols>(1) in Debian
broncodepakketten gebruikt worden.
In deze bestanden is de indeling van een item met informatie over een
afhankelijkheid van de uitgebreide gedeelde bibliotheek als volgt:
Z<>
I<bibliotheek-soname hoofd-afhankelijkheidssjabloon>
[| I<alternatief-afhankelijkheidssjabloon>]
[...]
[* I<veld-name>: I<veld-waarde>]
[...]
I<symbool> I<minimale-versie> [I<id-van-vereiste-sjabloon>]
De I<bibliotheeksoname> is exact de waarde van het veld SONAME zoals die
door B<objdump>(1) geëxporteerd wordt. Een I<afhankelijkheidssjabloon> is
een afhankelijkheid waarbij I<#MINVER#> dynamisch vervangen wordt door ofwel
een versietoets zoals “(E<gt>= I<minimale-versie>)” ofwel door niets (indien
een versieloze afhankelijkheid voldoende geacht wordt).
Elk geëxporteerd I<symbool> (vermeld als I<naam>@I<versie>, waarbij
I<versie> “Base” is als het een versieloze bibliotheek betreft) is
geassocieerd met een I<minimale-versie> van zijn afhankelijkheidssjabloon
(het hoofdafhankelijkheidssjabloon wordt altijd gebruikt en wordt
uiteindelijk gecombineerd met het afhankelijkheidssjabloon waarnaar verwezen
wordt door I<id-van-afhankelijkheidssjabloon> als dat voorhanden is). Het
eerste alternatieve afhankelijkheidssjabloon krijgt het nummer 1, het tweede
2 enzovoort. Elke kolom wordt door exact één witruimte gescheiden.
Elk item over een bibliotheek kan ook velden met meta-informatie
bevatten. Die velden worden opgeslagen in regels die beginnen met een
asterisk. Momenteel mogen enkel de volgende velden gebruikt worden:
=over
=item B<Build-Depends-Package>
Dit geeft de naam op van het “-dev”-pakket dat geassocieerd is met de
bibliotheek en het wordt gebruikt door B<dpkg-shlibdeps> om er zeker van te
zijn dat de gegenereerde afhankelijkheid minstens even strikt is als de
overeenkomstige bouw-afhankelijkheid (sinds dpkg 1.14.13)
=item B<Build-Depends-Packages>
Hetzelfde als B<Build-Depends-Package>, maar aanvaardt een door komma's
gescheiden lijst van pakketnamen (sins dpkg 1.20.0). Dit veld zal eventuele
bestaande B<Build-Depends-Package>-velden overschrijven en is vooral nuttig
voor “-dev”-pakketten en ervan afhankelijke metapakketten, bijvoorbeeld voor
een transitieperiode.
=item B<Allow-Internal-Symbol-Groups>
Dit vermeldt in een lijst met witruimte als scheidingsteken welke interne
symbolengroepen genegeerd moeten worden, zodat de symbolen uit deze groepen
mee opgenomen worden in het uitvoerbestand (sinds dpkg 1.20.1). Dit zou
enkel noodzakelijk moeten zijn voor pakketten uit de gereedschapskist die
deze interne symbolen ter beschikking stellen. De beschikbare groepen zijn
systeemafhankelijk en voor op ELF en op GNU gebaseerde systemen zijn dat
B<aeabi> en B<gomp>.
=item B<Ignore-Blacklist-Groups>
Een verouderde alias voor B<Allow-Internal-Symbol-Groups> (sins dpkg 1.20.1,
ondersteund sinds dpkg 1.17.6).
=back
=head1 VOORBEELDEN
=head2 Eenvoudig symboolbestand
libftp.so.3 libftp3 #MINVER#
DefaultNetbuf@Base 3.1-1-6
FtpAccess@Base 3.1-1-6
[...]
=head2 Geavanceerd symboolbestand
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 ZIE OOK
L<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>,
B<dpkg-shlibdeps>(1), B<dpkg-gensymbols>(1).
|
