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
234
235
236
237
238
239
240
241
242
243
244
245
246
247
|
*****************************************************
* 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 BEZEICHNUNG
deb-buildinfo - Format der Bauinformationsdateien von Debian
=head1 ÜBERSICHT
I<Dateiname>B<.buildinfo>
=head1 BESCHREIBUNG
Jeder Bau eines Debian-Quellpakets kann die Bauinformationen in einer
B<.buildinfo>-Steuerdatei aufzeichnen. Diese enthält eine Reihe von Feldern
im L<deb822(5)>-Format.
Jedes Feld beginnt mit einer Markierung, wie B<Source> oder B<Binary>
(Groß-/Kleinschreibung ist egal), gefolgt von einem Doppelpunkt und dem
Inhalt des Feldes (Groß-/Kleinschreibung ist relevant, außer anders
angegeben). Felder werden nur durch Feldmarkierungen begrenzt. Mit anderen
Worten, Felder können mehrere Zeilen umfassen, aber die
Installationswerkzeuge werden im Allgemeinen die Zeilen bei der Verarbeitung
des Feldinhaltes zusammenfassen (außer im Falle der mehrzeiligen Felder
B<Binary-Only-Changes>, B<Installed-Build-Depends>, B<Environment>,
B<Checksums-Md5>, B<Checksums-Sha1> und B<Checksums-Sha256>, siehe unten).
Die Steuerdaten können in eine Signatur mit einer wie in RFC4880
spezifizierten OpenPGP-ASCII-Hülle eingeschlossen sein.
Der Name der B<.buildinfo>-Datei wird von der Art des Baus abhängen und wird
so spezifisch wie notwendig sein, aber nicht mehr; für einen Bau, der B<any>
enthält, wird der Name
I<Quellname>B<_>I<Binärversion>B<_>I<Arch>B<.buildinfo> oder andernfalls für
einen Bau, der B<all> enthält, wird der Name
I<Quellname>B<_>I<Quellversion>B<_>B<all.buildinfo> oder andernfalls für
einen Bau, der B<source> enthält, wird der Name
I<Quellname>B<_>I<Binärversion>B<_>B<source.buildinfo> lauten.
=head1 FELDER
=over
=item B<Format:> I<Formatversion> (verpflichtend)
Das Wert dieses Feldes gibt die Formatversion der Datei an. Die Syntax des
Feldwertes ist eine Versionsnummer mit einer Haupt- und einer
Nebenkomponente. Rückwärtsinkompatible Änderungen im Format führen zu einer
Erhöhung der Hauptversion und rückwärtskompatible Änderungen (wie die
Aufnahme neuer Felder) führen zu einer Erhöhung der Nebenversion. Die
aktuelle Formatversion ist B<1.0>.
=item B<Source:> I<Quellname> [B<(>I<Quellversion>B<)>] (verpflichtend)
Der Name des Quellpakets. Falls sich die Quellversion von der Binärversion
unterscheidet, folgt dem I<Quellname>n in Klammern eine
I<Quellversion>. Dies kann passieren, falls der Bau für einen rein-binären,
nicht-Betreuer-Upload ist.
=item B<Binary:> I<Binärpaketliste> (verpflichtend im Kontext)
Dieses gefaltete Feld ist eine durch Leerzeichen getrennte Liste von
gebauten binären Paketen. Falls es sich um einen reinen Quell-Upload
handelt, wird dieses Feld ausgelassen (seit Dpkg 1.20.0).
=item B<Architecture:> I<Architekturliste> (verpflichtend)
Dieses durch Leerzeichen getrennte Feld führt die Architekturen der derzeit
gebauten Dateien auf. Typische Architekturen sind B<amd64>, B<armel>,
B<i386> usw. Beachten Sie, dass der Wert B<all> für architekturunabhängige
Pakete gedacht ist. Falls die Quelle für das Paket auch gebaut wird, ist der
besondere Eintrag B<source> auch vorhanden. Architektur-Platzhalter dürfen
in der Liste niemals auftauchen.
=item B<Version:> I<Versionszeichenkette> (verpflichtend)
Typischerweise ist das die Original-Paketversionsnummer, in der Form, die
der Programmautor verwendet. Es kann auch eine Debian-Revisionsnummer
enthalten (für nicht aus Debian stammende Pakete). Das genaue Format und der
Sortieralgorithmus sind in B<deb-version>(7) beschrieben.
=item B<Binary-Only-Changes:>
=item S< >I<Changelog-Eintrag>
Das mehrzeilige Feld enthält den aneinandergehängten Text des
Changelog-Eintrages eines rein binären, nicht-Betreuer-Uploads (binNMU),
sofern dies der Fall ist. Um ein gültiges mehrzeiliges Feld zu erhalten,
werden leere Zeilen durch ein einzelnen Satzpunkt (‚.’) ersetzt und alle
Zeilen mit einem Leerzeichen eingerückt. Der genaue Inhalt hängt vom
Changelog-Format ab.
=item B<Checksums-Md5:> (verpflichtend)
=item B<Checksums-Sha1:> (verpflichtend)
=item B<Checksums-Sha256:> (verpflichtend)
=item S< >I<Prüfsumme> I<Größe> I<Dateiname>
Diese mehrzeiligen Felder enthalten eine Liste von Dateien mit einer
Prüfsumme und Größe für jede. Diese Felder haben die gleiche Syntax und
unterscheiden sich nur im verwandten Prüfsummenalgorithmus: MD5 für
B<Checksums-Md5>, SHA-1 für B<Checksums-Sha1> und SHA-256 für
B<Checksums-Sha256>.
Die erste Zeile des Feldwertes (der Teil auf der gleichen Zeile wie der
durch einen Doppelpunkt gefolgte Feldname) ist immer leer. Der Inhalt des
Feldes wird durch Fortsetzungszeilen ausgedrückt, eine Zeile pro Datei. Jede
Zeile besteht aus durch Leerzeichen getrennten Einträgen, die die Datei
beschreiben: der Prüfsumme, der Dateigröße und dem Dateinamen.
Diese Datei führt alle Dateien auf, aus denen der Bau besteht.
=item B<Build-Origin:> I<Name>
Der Name der Distribution, aus der dieses Paket ursprünglich stammt.
=item B<Build-Architecture:> I<Arch> (verpflichtend)
Die Debian-Architektur für die Installation, unter der das Paket gebaut
wurde. Typische Architekturen sind B<amd64>, B<armel>, B<i386>, usw.
=item B<Build-Date:> I<Baudatum>
Das Datum, an dem das Paket letztmalig gebaut wurde. Es muss im gleichen
Format wie in einem Eintrag bei B<deb-changelog>(5) sein.
=item B<Build-Kernel-Version:> I<Bau-Kernel-Version>
Die Veröffentlichung und die Version (in einem nicht festgelegten Format)
des auf dem Bausystem laufenden Kernels. Dieses Feld ist nur vorhanden,
falls der Bauende es explizit angefordert hat, um zu verhindern, dass
vertrauliche Informationen versehentlich veröffentlicht werden.
=item B<Build-Path:> I<Baupfad>
Der absolute Baupfad, der dem entpackten Quellbaum entspricht. Dieses Feld
ist nur vorhanden, falls der Lieferant das Feld über ein Muster
freigeschaltet hat, um zu verhindern, dass vertrauliche Informationen
versehentlich veröffentlicht werden.
Unter Debian und abgeleiteten Distributionen werden nur Baupfade, die mit
I</build/> beginnen, dieses Feld ausgeben.
=item B<Build-Tainted-By:>
=item S< >I<taint-Begründungsliste>
Dieses gefaltete Feld enthält eine durch Leerzeichen getrennte, nicht
abschließende Liste von Markierungen (die durch alphanumerische und
Bindestrichzeichen aufgebaut werden), die identifizieren, warum der aktuelle
Bau unsauber (tainted) wurde (seit Dpkg 1.19.5).
Unter Debian und abgeleiteten Distributionen können die folgenden
Begründungsmarkierungen ausgegeben werden:
=over
=item B<merged-usr-via-aliased-dirs>
Das System hat ein mittels Alias-Verzeichnisse zusammengeführtes I</usr>
(früher B<merged-usr-via-symlinks> benannt). Dies wird B<dpkg-query>,
B<dpkg-statoverride>, B<dpkg-trigger>, B<update-alternatives> und weitere
Werkzeuge, die Pfadnamen als Schlüssel in ihren Datenbanken verwenden,
durcheinanderbringen, da es Dateisystem-Alias-Probleme erzeugt und bringt
das Verständnis, das B<dpkg> in seiner Datenbank aufnotiert hat,
durcheinander. Für Bausysteme, die Pfadnamen auf bestimmte Programme oder
Bibliotheken auf den enstandenen Artefakten hartkodieren, kann dies auch zu
Paketen führen, die mit nicht zusammengeführten /usr-Dateisystemen
inkompatibel sind.
=item B<usr-local-has-configs>
Das System hat Konfigurationsdateien unter I</usr/local/etc>.
=item B<usr-local-has-includes>
Das System hat Header-Dateien unter I</usr/local/include>.
=item B<usr-local-has-programs>
Das System hat Programme unter I</usr/local/bin> oder I</usr/local/sbin>.
=item B<usr-local-has-libraries>
Das System hat Bibliotheken, entweder statische oder Laufzeit-, unter
I</usr/local/lib>.
=back
=item B<Installed-Build-Depends:> (verpflichtend)
=item S< >I<Paketliste>
Die Liste der installierten und konfigurierten Pakete, die den Bauprozess
des Pakets beeinflussen könnten.
Die Liste besteht aus jedem Paketnamen, optional architekturqualifiziert für
fremde Architekturen, mit einer genauen Versionseinschränkung, getrennt
durch Kommata.
Die Liste enthält alle essenziellen Pakete, die in Quell-Steuerfeldern
B<Build-Depends>, B<Build-Depends-Arch>, B<Build-Depends-Indep> aufgeführten
Pakete, alle Lieferanten-spezifischen eingebauten Abhängigkeiten und alle
ihre rekursiven Abhängigkeiten. Unter Debian und abgeleiteten Distributionen
ist die eingebaute Abhängigkeit B<build-essential>.
Für Abhängigkeiten aus den Quellsteuerfeldern werden alle
Abhängigkeitsalternativen und alle Anbieter abhängiger virtueller Pakete mit
aufgenommen.
=item B<Umgebung>
=item S< >I<Variablenliste>
Die Liste der Umgebungsvariablen, die bekanntermaßen den Paketbauprozess
beeinflussen, wobei jede Umgebungsvariable von einem Gleichheitszeichen
(,=’) und dem mit Rückwärtsschrägstrichen (,\\’) maskierten Wert in
doppelten Anführungszeichen (,=’) gefolgt wird.
=back
=head1 SIEHE AUCH
L<deb822(5)>, B<deb-changes>(5), B<deb-version>(7), B<dpkg-genbuildinfo>(1).
=head1 ÜBERSETZUNG
Die deutsche Übersetzung wurde 2004, 2006-2020 von Helge Kreutzmann
<debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
2008 von Sven Joachim <svenjoac@gmx.de>
angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
Es gibt KEINE HAFTUNG.
|
