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
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
|
*****************************************************
* 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 NAMN
deb-buildinfo - filformat för Debiansbygginformation
=head1 SYNOPS
I<filnamn>B<.buildinfo>
=head1 BESKRIVNING
Alla Debian-källkodspaket kan lagra bygginformation i en
B<.buildinfo>-styrfil, som innehåller ett antal fält i L<deb822(5)>-format.
Varje fält börjar med en etikett, såsom B<Source> eller B<Binary>
(skiftlägesoberoende), följt av ett kolontecken och fältets kropp
(skiftlägesberoende såvida inte annat anges). Fält avdelas endast av
fältetiketter. Med andra ord kan texten i fälten spänna över flera rader,
men installationsverktygen kommer oftast att slå samman rader när kroppen
tolkas (förutom när det gäller flerradsfälten B<Binary-Only-Changes>,
B<Installed-Build-Depends>, B<Environment>, B<Checksums-Md5>,
B<Checksums-Sha1> och B<Checksums-Sha256>, se nedan).
Styrinformationen kan omges av en OpenPGP-signatur i ASCII-skal, såsom
beskrivs i RFC4880.
Namnet på B<.buildinfo>-filen kommer att bero på byggtypen och kommer att
vara så specifik som möjligt, men inte mer; för ett bygge som innehåller
B<any> (någon) kommer namnet vara
I<källkodsnamn>B<_>I<binärversion>B<_>I<ark>B<.buildinfo>, om bygget annars
innehåller B<all> (alla) kommer namnet vara
I<källkodsnamn>B<_>I<binärversion>B<_>B<all.buildinfo>, om bygget annars
innehåller B<source> (källkod) kommer namnet vara
I<källkodsnamn>B<_>I<källkodsversion>B<_>B<source.buildinfo>.
=head1 FÄLT
=over
=item B<Format:> I<formatversion> (krävs)
Värdet för fältet anger filens formatversion. Fältets syntax är ett
versionsnummer med en huvud- och en underdel. Ändringar som inte är
bakåtkompatibla ökar huvudversionen medan ändringar som är bakåtkompatibla
(till exempel nya fält) ökar underversionen. Aktuell formatversion är
B<1.0>.
=item B<Source:> I<källkodsnamn> [B<(>I<källkodsversion>B<)>] (krävs)
Namnet på källkodspaketet. Om källkodsversionen skiljer sig från
binärversionen kommer I<källkodsnamn> följas av I<källkodsversion> i
parentes. Detta kan uppstå när bygget är för en insändning bestående av
enbart binärer från någon annan än den paketansvarige (”binary-only
non-maintainer upload”).
=item B<Binary:> I<binärpaketlista> (krävs i sammanhang)
Det här flerdelade fältet är en blankstegsavdelad lista över byggda
binärpaket. Om endast källkod byggs kommer fältet att uteslutas (sedan dpkg
1.20.0).
=item B<Architecture:> I<ark-lista> (krävs)
Detta blankstegsavdelade fält anger vilken sorts maskinvara paketet för
tillfället byggs för. Vanliga arkitekturer är B<amd64>, B<armel>, B<i386>
osv. Observera att värdet B<all> är avsett för paket som är oberoende av
arkitektur. Om källkoden för paketet också byggs kommer specialposten
B<source> också vara med. Arkitekturer med jokertecken är inte tillåtna i
listan.
=item B<Version:> I<versionssträng> (krävs)
Vanligtvis är detta det ursprungliga paketets versionsnummer på den form
programmets författare använder. Den kan även innehålla ett
Debianuppdateringsnummer (för paket vars källa är utanför Debian). Exakt
format och sorteringsalgoritm beskrivs i B<deb-version>(7).
=item B<Binary-Only-Changes:>
=item S< >I<post-från-ändringsloggen>
Det här flerradiga fältet innehåller den sammanslagna texten från
ändringsloggposter för en insändning av enbart binärer från någon annan än
paketansvarige (”binary-only non-maintainer upload”, binNMU) om detta är
tillfället. För att göra fältet till ett giltigt flerradsfält ersätts tomma
rader med en ensam punkt (”.”) och alla rader får ett teckens indrag. Exakt
innehåll beror på formatet på ändringsloggen.
=item B<Checksums-Md5:> (krävs)
=item B<Checksums-Sha1:> (krävs)
=item B<Checksums-Sha256:> (krävs)
=item S< >I<kontrollsumma> I<storlek> I<filnamn>
De här flerradsfälteten innehåller en lista med filer med en kontrollsumma
och storlek för var och en. Fälten har samma syntax och skiljer sig bara vad
gäller vilken kontrollsummealgoritm som används: MD5 för B<Checksums-Md5>,
SHA-1 för B<Checksums-Sha1> och SHA-256 för B<Checksums-Sha256>.
Första raden i fältvärdet (delen av på samma rad som fältnamnet följt av
kolon) är alltid tom. Innehållet i fältet anges som fortsättningsrader, en
rad per fil. Varje rad består av blankstegsavdelade fält som beskriver
filen: kontrollsumman, filstorleken och filnamnet.
De här fälten visar alla filer bygget består av.
=item B<Build-Origin:> I<namn>
Namnet på den distribution paketet härstammar från.
=item B<Build-Architecture:> I<ark> (krävs)
Debianarkitekturen för den installation paketen byggs i. Vanliga
arkitekturer är B<amd64>, B<armel>, B<i386> osv.
=item B<Build-Date:> I<byggdatum>
Datumet paketet byggdes. Det måste vara på samma format som datumet i en
B<deb-changelog>(5)-post.
=item B<Build-Kernel-Version:> I<byggkärneversion>
Utgåva och version (i ett inte specificerat format) för kärnan som körs på
byggsystemet. Fältet kommer endast finnas om byggaren specifikt har bett om
det, för att undgå att läcka möjligt känslig information.
=item B<Build-Path:> I<byggsökväg>
Absolut byggsökväg som motsvarar det uppackade källkodsträdet. Fältet kommer
endast finnas om återförsäljaren tillåter det via en mönsterigenkänning för
att undgå att läcka möjligt känslig information.
På Debian och dess derivat tillåts bara byggsökvägar som börjar med
I</build/> att ta med detta fält.
=item B<Build-Tainted-By:>
=item S< >I<lista-fördärvelsesorsaker>
Det här flerdelade fältet innehåller en blankstegsavdelad lista över
ofullständiga orsagstaggar (bestående av alfanumeriska tecken och
bindestreck) som anger varför aktuellt bygge har fördärvats (sedan dpkg
1.19.5).
På Debian och dess derivat kan följande orsakstaggar skapas:
=over
=item B<merged-usr-via-aliased-dirs>
Systemet har en sammanslagen I</usr> via aliaskataloger (tidigare känt som
B<merged-usr-via-symlinks>). Detta kommer förvirra B<dpkg-query>,
B<dpkg-statoverride>, B<dpkg-trigger>, B<update-alternatives> och andra
verktyg som använder sökvägsnamn som nyckel i sina databaser, eftersom det
skapar filsystemaliasproblem och stör förståelsen av filsystemet som B<dpkg>
har lagrat i sin databas. För byggsystem som hårdkodar sökvägar till
specifika binärer eller bibliotek i de resulterande artefakterna kan det
också skapa paket som är inkompatibla med system som inte har
/usr-sammanslagna filsystem.
=item B<usr-local-has-configs>
Systemet har konfigurationsfiler under I</usr/local/etc>.
=item B<usr-local-has-includes>
Systemer har huvudfiler under I</usr/local/include>.
=item B<usr-local-has-programs>
Systemet har program under I</usr/local/bin> och I</usr/local/sbin>.
=item B<usr-local-has-libraries>
Systemet har bibliotek, antingen statiska eller delade, under
I</usr/local/lib>.
=back
=item B<Installed-Build-Depends:> (krävs)
=item S< >I<paketlista>
Listan över intallerade och konfigurerade paket som kan påverka paketets
byggprocess.
Listan innehåller varje paketnamn, möjligen med en angiven arkitektur för
oegna arkitekturer, med en exakt versionsbegränsning, avdelade med
kommatecken.
Listan innehåller alla systemkritiska paket, paket angivna i källkodens
styrfält B<Build-Depends>, B<Build-Depends-Arch>, B<Build-Depends-Indep>,
eventuella återförsäljarspecifika inbyggda beroenden och alla deras
rekursiva beroenden. På Debian och dess derivat är det inbyggda beroendet
B<build-essential>.
Alla beroendealternativ och alla försöjare av virtuella paketberoenden
kommer tas med för beroenden som kommer från fält i källkodsstyrfilen.
=item B<Environment:>
=item S< >I<variabellista>
Listan över miljövariabler som är kända för att påverka paketbyggprocessen,
där varje miljövariabel följs av ett likamedtecken (”=”) och variabelns
citerade värde, inom dubbla citattecken (’"’) och med omvända snedstreck
ersatta (”\\”).
=back
=head1 SE ÄVEN
L<deb822(5)>, B<deb-changes>(5), B<deb-version>(7), B<dpkg-genbuildinfo>(1).
=head1 ÖVERSÄTTNING
Peter Krefting och Daniel Nylander.
|
