summaryrefslogtreecommitdiffstats
path: root/man/nl/deb-buildinfo.pod
blob: b513fc771cbd1be4abd6233a7b19ee4fef617c8c (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
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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
        *****************************************************
        *           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-buildinfo - Indeling van het Debian bouw-informatiebestand

=head1 OVERZICHT

I<bestandsnaam>B<.buildinfo>

=head1 BESCHRIJVING

Van elke bouw van een Debian broncodepakket kan de bouwinformatie opgeslagen worden in een controlebestand B<.buildinfo>, dat een aantal velden bevat volgens de indeling L<deb822(5)>.

Ieder veld begint met een markering, zoals B<Source> of B<Binary> (niet hoofdlettergevoelig), gevolgd door een dubbele punt en de tekstinhoud van het veld (hoofdlettergevoelig tenzij anders vermeld). Velden worden enkel door veldmarkeringen begrensd. De tekstinhoud van het veld kan met andere woorden verschillende regels lang zijn, maar de installatiegereedschappen zullen bij het verwerken van de tekstinhoud de regels gewoonlijk samenvoegen (behalve in het geval van de multiregel-velden B<Binary-Only-Changes>, B<Installed-Build-Depends>, B<Environment>, B<Checksums-Md5>, B<Checksums-Sha1> en B<Checksums-Sha256>; zie hierna)

De controle-data mogen ingesloten liggen in een OpenPGP-handtekening met ASCII-harnas volgens de specificatie RFC4880.

De naam van het B<.buildinfo>-bestand zal afhangen van het type bouw en zal zo specifiek zijn als nodig, maar niet meer dan dat; die naam zal zijn:

=over 

=item I<broncode-naam>B<_>I<versie-binair-bestand>B<_>I<arch>B<.buildinfo>

voor een bouw die B<any> bevat

=item I<broncode-naam>B<_>I<versie-binair-bestand>B<_>B<all.buildinfo>

voor een bouw die daarentegen B<all> bevat

=item I<broncode-naam>B<_>I<broncode-versie>B<_>B<source.buildinfo>

voor een bouw die daarentegen B<source> bevat

=back

=head1 VELDEN

=over 

=item B<Format:> I<indelingsversie> (verplicht)

De waarde van dit veld bepaalt de indelingsversie van het bestand. De syntaxis van de veldwaarde is een versienummer met een hoofdversie- en een onderversiecomponent. Wijzigingen aan de indeling die niet neerwaarts compatibel zijn, hebben een verhoging van het hoofdversienummer tot gevolg en neerwaarts compatibele veranderingen (zoals het toevoegen van extra velden) verhogen het onderversienummer. De huidige indelingsversie is B<1.0>.

=item B<Source:> I<broncode-naam> [B<(>I<broncode-versie>B<)>] (verplicht)

De naam van het broncodepakket. Indien de versie van het broncodepakket verschilt van de versie van het binaire pakket, dan zal de I<broncode-naam> gevolgd worden door een I<broncode-versie> tussen haakjes. Dit kan het geval zijn als de bouw gebeurt voor een uitsluitend binaire upload die niet door de beheerder uitgevoerd wordt.

=item B<Binary:> I<lijst-binaire-pakketten> (vereist in de context)

Dit samengevouwen veld is een met een spatie gescheiden lijst van gebouwde binaire pakketten. Indien de bouw enkel de broncode betreft, dan wordt het veld weggelaten (sinds dpkg 1.20.0).

=item B<Architecture:> I<arch-lijst> (verplicht)

Dit veld met spaties als scheidingsteken, somt de architecturen op van de bestanden die momenteel gebouwd worden. Gebruikelijke architecturen zijn B<amd64>, B<armel>, B<i386>, enz. Merk op dat de waarde B<all> bedoeld is voor pakketten die architectuuronafhankelijk zijn. Indien ook de broncode voor het pakket gebouwd wordt, is ook de bijzondere vermelding B<source> aanwezig. Jokertekens voor architecturen mogen nooit voorkomen in de lijst.

=item B<Version:> I<versie-tekenreeks> (verplicht)

Gewoonlijk is dit het originele versienummer van het pakket, welke vorm de auteur van het programma er ook voor gebruikt. Het kan ook een Debian-revisienummer bevatten (voor niet uit Debian stammende pakketten). De exacte indeling en het sorteringsalgoritme worden beschreven in L<deb-version(7)>.

=item B<Binary-Only-Changes:>

=item S< >I<changelog-item>

Dit multiregel-veld bevat in voorkomend geval de samengevoegde tekst van het changelog-item voor een uitsluitend binaire upload die niet door de beheerder uitgevoerd wordt (een binary-only non-maintainer upload - binNMU). Om van dit veld een geldig multiregel-veld te maken, worden lege regels vervangen door één enkel punt (‘.’) en springen alle regels in met één spatie. De exacte inhoud hangt af van de changelog-indeling.

=item B<Checksums-Md5:> (verplicht)

=item B<Checksums-Sha1:> (verplicht)

=item B<Checksums-Sha256:> (verplicht)

=item S< >I<controlesom> I<grootte> I<bestandsnaam>

Deze multiregel-velden bevatten een lijst van bestanden met voor elk van hen een controlesom en een grootte. Deze velden hebben een identieke syntaxis en verschillen onderling enkel inzake het gebruikte algoritme voor de controlesom: MD5 voor B<Checksums-Md5>, SHA-1 voor B<Checksums-Sha1> en SHA-256 voor B<Checksums-Sha256>.

De eerste regel van de veldwaarde (het deel dat op dezelfde regel staat als de door een dubbele punt gevolgde veldnaam) is steeds leeg. De inhoud van het veld wordt in de vervolgregels verwoord, één regel per bestand. Elke regel bestaat uit elementen die onderling door een spatie gescheiden zijn en het bestand beschrijven: zijn controlesom, zijn bestandsgrootte en zijn naam.

Deze velden sommen alle bestanden die de bouw vormen.

=item B<Build-Origin:> I<naam>

De naam van de distributie waaruit dit pakket afkomstig is.

=item B<Build-Architecture:> I<arch> (verplicht)

De Debian-architectuur van de installatie waarin de pakketten gebouwd worden. Gebruikelijke architecturen zijn B<amd64>, B<armel>, B<i386>, enz.

=item B<Build-Date:> I<bouwdatum>

De datum waarop het pakket gebouwd werd. Hij moet dezelfde indeling hebben als de datum in een L<deb-changelog(5)>-item.

=item B<Build-Kernel-Version:> I<bouwkernel-versie>

De uitgave en de versie (in een niet-gespecificeerde indeling) van de kernel die op het bouwsysteem functioneert. Dit veld zal enkel aanwezig zijn als het bouwprogramma er expliciet om gevraagd heeft, om het eventueel weglekken van gevoelige informatie te voorkomen.

=item B<Build-Path:> I<bouwpad>

Het absoluut bouwpad, wat overeenkomt met de uitgepakte broncodeboom. Dit veld is enkel aanwezig als de leverancier het toegelaten heeft aan de hand van een patroonvergelijking om het eventueel weglekken van gevoelige informatie te voorkomen.

Op Debian en zijn derivaten zullen enkel bouwpaden die beginnen met I</build/> aanleiding geven tot het aanmaken van dit veld.

=item B<Build-Tainted-By:>

=item S< >I<lijst-met-bezoedelingsredenen>

Dit gevouwen veld bevat een niet-exhaustieve lijst, met spatie als scheidingsteken, van labels (samengesteld uit alfanumerieke tekens en gedachtestreepjes) met redenen die aanduiden waarom de huidige bouw bezoedeld werd (sinds dpkg 1.19.5).

Op Debian en zijn derivaten kunnen de volgende reden-labels gegeven worden:

=over 

=item B<merged-usr-via-aliased-dirs>

Het systeem heeft een via aliassen samengevoegde map I</usr> (vroeger gekend als B<merged-usr-via-symlinks>). Dit sticht verwarring bij B<dpkg-query>, B<dpkg-statoverride>, B<dpkg-trigger>, B<update-alternatives> en elk ander hulpmiddel dat in zijn databank gebruik maakt van padnamen als sleutel, omdat het zorgt voor problemen met aliassen in het bestandssysteem en knoeit met het overzicht van het bestandssysteem dat B<dpkg> in zijn databank opgeslagen heeft. Met bouwsystemen die in de door hen gemaakte objecten gebruik maken van vaste padnamen naar specifieke uitvoerbare bestanden of bibliotheken, kan dit ook leiden tot pakketten die niet compatibel zijn met bestandssystemen zonder samengevoegde /usr-map.

=item B<usr-local-has-configs>

Het systeem bevat configuratiebestanden onder I</usr/local/etc>.

=item B<usr-local-has-includes>

Het systeem bevat kopbestanden onder I</usr/local/include>.

=item B<usr-local-has-programs>

Op het systeem staan programma's onder I</usr/local/bin> of I</usr/local/sbin>.

=item B<usr-local-has-libraries>

Het systeem bevat statische of gedeelde bibliotheken onder I</usr/local/lib>.

=item B<can-execute-cross-built-programs>

Het systeem kan voor andere platformen gebouwde programma's uitvoeren, hetzij rechtstreeks, hetzij via een emulatielaag.

Sinds dpkg 1.21.10.

=back

=item B<Installed-Build-Depends:> (verplicht)

=item S< >I<pakketlijst>

De lijst van geïnstalleerde en geconfigureerde pakketten die van invloed kunnen zijn op het proces van het bouwen van het pakket.

De lijst bestaat uit de naam van elk pakket, eventueel een architectuurkwalificatie voor andere architecturen, met een exacte versierestrictie, gescheiden door komma's.

De lijst bevat alle essentiële pakketten, pakketten vermeld in velden B<Build-Depends>, B<Build-Depends-Arch>, B<Build-Depends-Indep> van de broncode, eventuele ingebouwde leveranciersspecifieke vereisten en al hun recursieve vereisten. Op Debian en zijn derivaten is de ingebouwde vereiste B<build-essential>.

Waar het vereisten betreft die afkomstig zijn uit de controlevelden van de broncode, worden ook alle vereistenalternatieven in aanmerking genomen en alle pakketten die voorzien in de virtuele pakketten die vereist worden.

=item B<Environment:>

=item S< >I<variabelelijst>

De lijst met omgevingsvariabelen waarvan bekend is dat zij het proces van het bouwen van het pakket beïnvloeden, waarbij elke variabele gevolgd wordt door een gelijkheidsteken (‘=’) en de waarde van de variabele tussen aanhalingstekens, wat dubbele aanhalingstekens (‘"’) moeten zijn, en waarbij de backslashes worden gemaskeerd (‘\\’).

=back

=head1 ZIE OOK

L<deb822(5)>, L<deb-changes(5)>, L<deb-version(7)>, L<dpkg-genbuildinfo(1)>.