chiark / gitweb /
awful debugging hacking
[dpkg] / man / de / dpkg-buildpackage.man
1 .\" dpkg manual page - dpkg-buildpackage(1)
2 .\"
3 .\" Copyright © 1995-1996 Ian Jackson
4 .\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org>
5 .\" Copyright © 2007-2008 Frank Lichtenheld <djpig@debian.org>
6 .\" Copyright © 2008-2015 Guillem Jover <guillem@debian.org>
7 .\" Copyright © 2008-2012 Raphaël Hertzog <hertzog@debian.org>
8 .\"
9 .\" This is free software; you can redistribute it and/or modify
10 .\" it under the terms of the GNU General Public License as published by
11 .\" the Free Software Foundation; either version 2 of the License, or
12 .\" (at your option) any later version.
13 .\"
14 .\" This is distributed in the hope that it will be useful,
15 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
16 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17 .\" GNU General Public License for more details.
18 .\"
19 .\" You should have received a copy of the GNU General Public License
20 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
21 .
22 .\"*******************************************************************
23 .\"
24 .\" This file was generated with po4a. Translate the source file.
25 .\"
26 .\"*******************************************************************
27 .TH dpkg\-buildpackage 1 %RELEASE_DATE% %VERSION% dpkg\-Programmsammlung
28 .nh
29 .SH BEZEICHNUNG
30 dpkg\-buildpackage \- baue Binär\- oder Quellpakete aus Quellen
31 .
32 .SH ÜBERSICHT
33 \fBdpkg\-buildpackage\fP [\fIOption\fP …]
34 .
35 .SH BESCHREIBUNG
36 \fBdpkg\-buildpackage\fP ist ein Programm, das den Prozess des Bauens eines
37 Debian\-Paketes automatisiert. Es besteht aus den folgenden Schritten:
38 .IP \fB1.\fP 3
39 Es bereitet die Bauumgebung vor, indem verschiedene Umgebungsvariablen
40 gesetzt werden (siehe \fBUMGEBUNG\fP), führt den \fBinit\fP\-Hook aus und ruft
41 \fBdpkg\-source \-\-before\-build\fP auf (es sei denn, \fB\-T\fP oder \fB\-\-target\fP wurde
42 verwandt).
43 .IP \fB2.\fP 3
44 Es prüft, dass Bauabhängigkeiten und \-konflikte erfüllt sind (falls \fB\-d\fP
45 oder \fB\-\-no\-check\-builddeps\fP nicht angegeben ist).
46 .IP \fB3.\fP 3
47 Falls eines oder mehrere spezielle Ziele mit der Option \fB\-T\fP oder
48 \fB\-\-target\fP ausgewählt wurden, ruft es diese Ziele auf und endet
49 hier. Andernfalls führt es den Hook \fBpreclean\fP aus und ruft \fBfakeroot
50 debian/ rules clean\fP auf, um den Bau\-Baum zu bereinigen (falls \fB\-nc\fP oder
51 \fB\-\-no\-pre\-clean\fP nicht angegeben ist).
52 .IP \fB4.\fP 3
53 Es führt den Hook \fBsource\fP aus und ruft \fBdpkg\-source \-b\fP auf, um das
54 Quellpaket zu erstellen (falls mit \fB\-\-build\fP oder äquivalenten Optionen ein
55 \fBsource\fP (Quell\-)Bau erbeten wurde).
56 .IP \fB5.\fP 3
57 Es führt den Hook \fBbuild\fP aus und ruft \fBdebian/rules\fP \fIBauziel\fP auf. Dann
58 führt es den Hook \fBbinary\fP aus, gefolgt von \fBfakeroot debian/rules\fP
59 \fIBinärziel\fP auf (falls nicht ein reiner Quellbau mit \fB\-\-build=source\fP oder
60 äquivalenten Optionen erbeten wurde). Beachten Sie, dass \fIBauziel\fP und
61 \fIBinärziel\fP entweder \fBbuild\fP und \fBbinary\fP (Standardfall, oder falls
62 \fBany\fP\- und \fBall\fP\-Bau mit \fB\-\-build\fP oder äquivalenten Optionen erbeten
63 wurde) oder \fBbuild\-arch\fP und \fBbinary\-arch\fP (falls ein \fBany\fP\- und nicht
64 \fBall\fP\-Bau mit \fB\-\-build\fP oder äquivalenten Optionen erbeten wurde) oder
65 \fBbuild\-indep\fP und \fBbinary\-indep\fP (falls ein \fBall\fP\- und nicht \fBany\fP\-Bau
66 mit \fB\-\-build\fP oder äquivalenten Optionen erbeten wurde).
67 .IP \fB6.\fP 3
68 Es führt den Hook \fBbuildinfo\fP aus und ruft \fBdpkg\-genbuildinfo\fP auf, um
69 eine \fB.buildinfo\fP\-Datei zu erstellen. Viele Optionen von
70 \fBdpkg\-buildpackage\fP werden an \fBdpkg\-genbuildinfo\fP weitergeleitet.
71 .IP \fB7.\fP 3
72 Es führt die \fBchanges\fP\-Hooks aus und ruft \fBdpkg\-genchanges\fP auf, um eine
73 \&\fB.changes\fP\-Datei zu erstellen. Der Name der \fB.changes\fP\-Datei wird von der
74 Art des Baus abhängen und wird so spezifisch wie notwendig sein, aber nicht
75 mehr; für einen Bau, der \fBany\fP enthält, wird der Name
76 \fIQuellname\fP\fB_\fP\fIBinärversion\fP\fB_\fP\fIArch\fP\fB.changes\fP oder andernfalls für
77 einen Bau, der \fBall\fP enthält, wird der Name
78 \fIQuellname\fP\fB_\fP\fIBinärversion\fP\fB_\fP\fBall.changes\fP oder andernfalls für einen
79 Bau, der \fBsource\fP enthält, wird der Name
80 \fIQuellname\fP\fB_\fP\fIQuellversion\fP\fB_\fP\fBsource.changes\fP lauten. Viele Optionen
81 von \fBdpkg\-buildpackage\fP werden an \fBdpkg\-genchanges\fP weitergegeben.
82 .IP \fB8.\fP 3
83 Es führt den Hook \fBpostclean\fP aus und, falls \fB\-tc\fP oder \fB\-\-post\-clean\fP
84 angegeben ist, ruft es erneut \fBfakeroot debian/rules clean\fP auf.
85 .IP \fB9.\fP 3
86 \fBdpkg\-source \-\-after\-build\fP wird aufgerufen.
87 .IP \fB10.\fP 3
88 Es führt den Hook \fBcheck\fP aus und ruft einen Paketprüfer für die Datei
89 \&\fB.changes\fP auf (falls ein Befehl in \fBDEB_CHECK_COMMAND\fP oder mit
90 \fB\-\-check\-command\fP angegeben ist).
91 .IP \fB11.\fP 3
92 Es führt den Hook \fBsign\fP aus und ruft \fBgpg2\fP oder \fBgpg\fP auf (so lange es
93 sich nicht um einen »UNRELEASED«\-Bau handelt oder \fB\-\-no\-sign\fP angegeben
94 wurde), um die \fB.dsc\fP\-Datei (falls vorhanden und \fB\-us\fP oder
95 \fB\-\-unsigned\-source\fP nicht angegeben wurde), die \fB.buildinfo\fP\-Datei (falls
96 \fB\-ui\fP, \fB\-\-unsigned\-buildinfo\fP, \fB\-uc\fP oder \fB\-\-unsigned\-changes\fP nicht
97 angegeben wurden) und die \fB.changes\fP\-Datei (falls \fB\-uc\fP oder
98 \fB\-\-unsigned\-changes\fP nicht angegeben wurde) zu unterschreiben.
99 .IP \fB12.\fP 3
100 Es führt den Hook \fBdone\fP aus.
101 .
102 .SH OPTIONEN
103 Alle langen Optionen können auf der Befehlszeile oder im
104 \fBdpkg\-buildpackage\fP\-System und Benutzerkonfigurationsdateien angegeben
105 werden. Jede Zeile in der Konfigurationsdatei ist entweder eine Option
106 (exakt die gleiche wie die Befehlszeilenoption nur ohne führende
107 Gedankenstriche) oder ein Kommentar (falls sie mit ‚\fB#\fP’) beginnt).
108
109 .TP 
110 \fB\-\-build=\fP\fITyp\fP
111 Spezifiziert den Bau\-\fITyp\fP aus einer Kommata\-getrennten Liste von
112 Komponenten (seit Dpkg 1.18.5). Wird an \fBdpkg\-genchanges\fP weitergegeben.
113
114 Die erlaubten Werte sind:
115 .RS
116 .TP 
117 \fBsource\fP
118 Baut das Quellpaket: Hinweis: Falls Sie diesen Wert alleine verwenden und
119 falls Sie einfach das Quellpaket (neu) bauen möchten, ist die Verwendung von
120 \fBdpkg\-source\fP immer besser, da dafür keine Bauabhängigkeiten installiert
121 sein müssen, um das Ziel \fBclean\fP aufzurufen.
122 .TP 
123 \fBany\fP
124 Baut das architekturspezifische Binärpaket.
125 .TP 
126 \fBall\fP
127 Baut die architekturunabhängigen Pakete.
128 .TP 
129 \fBbinary\fP
130 Baut die architekturspezifischen und \-unabhängigen Binärpakete. Dies ist ein
131 Alias für \fBany,all\fP.
132 .TP 
133 \fBfull\fP
134 Baut alles. Dies ist ein Alias für \fBsource,any,all\fP und identisch zum
135 Standardfall, wenn keine Bauoptionen festgelegt werden.
136 .RE
137 .TP 
138 \fB\-g\fP
139 Äquivalent zu \fB\-\-build=source,all\fP (seit Dpkg 1.17.11).
140 .TP 
141 \fB\-G\fP
142 Äquivalent zu \fB\-\-build=source,any\fP (seit Dpkg 1.17.11).
143 .TP 
144 \fB\-b\fP
145 Äquivalent zu \fB\-\-build=binary\fP oder \fB\-\-build=any,all\fP.
146 .TP 
147 \fB\-B\fP
148 Äquivalent zu \fB\-\-build=any\fP.
149 .TP 
150 \fB\-A\fP
151 Äquivalent zu \fB\-\-build=all\fP.
152 .TP 
153 \fB\-S\fP
154 Äquivalent zu \fB\-\-build=source\fP.
155 .TP 
156 \fB\-F\fP
157 Äquivalent zu \fB\-\-build=full\fP, \fB\-\-build=source,binary\fP oder
158 \fB\-\-build=source,any,all\fP (seit Dpkg 1.15.8).
159 .TP 
160 \fB\-\-target=\fP\fIZiel\fP[,…]
161 .TQ
162 \fB\-\-target \fP\fIZiel\fP[,…]
163 .TQ
164 \fB\-T\fP, \fB\-\-rules\-target=\fP\fIZiel\fP[,…]
165 Ruft \fBdebian/rules\fP \fIZiel\fP einmal pro angegebenem Ziel auf, nachdem die
166 Bauumgebung eingerichtet wurde (außer dass \fBdpkg\-source \-\-before\-build\fP
167 aufgerufen wird) und beendet den Paketbauprozess hier (seit Dpkg 1.15.0,
168 lange Optionen seit Dpkg 1.18.8, Unterstützung für mehrere Ziele seit Dpkg
169 1.18.16). Falls auch \fB\-\-as\-root\fP angegeben wurde, wird der Befehl mit
170 root\-Rechten ausgeführt (siehe \fB\-\-root\-command\fP). Beachten Sie, dass
171 bekannte Ziele, die als Root ausgeführt werden müssen, diese Option nicht
172 benötigen (d.h. die Ziele \fBclean\fP, \fBbinary\fP, \fBbinary\-arch\fP und
173 \fBbinary\-indep\fP).
174 .TP 
175 \fB\-\-as\-root\fP
176 Ergibt nur mit \fB\-\-target\fP einen Sinn (seit Dpkg 1.15.0). Erfordert, dass
177 das Ziel mit Root\-Rechten ausgeführt wird.
178 .TP 
179 \fB\-si\fP
180 .TQ
181 \fB\-sa\fP
182 .TQ
183 \fB\-sd\fP
184 .TQ
185 \fB\-v\fP\fIVersion\fP
186 .TQ
187 \fB\-C\fP\fIÄnderungsbeschreibung\fP
188 .TQ
189 \fB\-m\fP, \fB\-\-release\-by=\fP\fIBetreueradresse\fP
190 .TQ
191 \fB\-e\fP, \fB\-\-build\-by=\fP\fIBetreueradresse\fP
192 Wird unverändert an \fBdpkg\-genchanges\fP weitergegeben. Lesen Sie dessen
193 Handbuchseite.
194 .TP 
195 \fB\-a\fP, \fB\-\-host\-arch\fP \fIArchitektur\fP
196 Spezifiziert die Debian\-Architektur, für die gebaut wird (lange Option seit
197 Dpkg 1.17.17). Die Architektur der Maschine, auf der gebaut wird, wird
198 automatisch bestimmt, und ist auch die Voreinstellung für die
199 Gastgebermaschine (»host machine«).
200 .TP 
201 \fB\-t\fP, \fB\-\-host\-type\fP \fIGNU\-Systemtyp\fP
202 Spezifiziere den GNU\-Systemtyp, für den wir bauen (lange Option seit Dpkg
203 1.17.17). Er kann anstelle von \fB\-\-host\-arch\fP oder als Ergänzung verwandt
204 werden, um den Standard GNU\-Systemtyp der Host\-Debian\-Architektur außer
205 Kraft zu setzen.
206 .TP 
207 \fB\-\-target\-arch\fP \fIArchitektur\fP
208 Spezifiziert die Debian\-Architektur, für die die gebauten Programme bauen
209 werden (seit Dpkg 1.17.17). Die Voreinstellung ist die Host\-Maschine.
210 .TP 
211 \fB\-\-target\-type\fP \fIGNU\-Systemtyp\fP
212 Spezifiziere den GNU\-Systemtyp, für den die gebauten Programme bauen werden
213 (seit Dpkg 1.17.17). Er kann anstelle von \fB\-\-target\-arch\fP oder als
214 Ergänzung verwandt werden, um den Standard GNU\-Systemtyp der
215 Ziel\-Debian\-Architektur zu überschreiben.
216 .TP 
217 \fB\-P\fP, \fB\-\-build\-profiles=\fP\fIProfil\fP[\fB,\fP…]
218 Gibt als Kommata\-getrennte Liste die zu bauenden Profile an (seit Dpkg
219 1.17.2, lange Optionen seit Dpkg 1.18.8). Standardmäßig wird für kein
220 bestimmtes Profil gebaut. Setzt sie auch (als durch Leerzeichen getrennte
221 Liste) in die Umgebungsvariable \fBDEB_BUILD_PROFILES\fP. Dies erlaubt
222 beispielsweise \fBdebian/rules\fP\-Dateien, diese Information für den Bau unter
223 bestimmten Bedingungen zu nutzen.
224 .TP 
225 \fB\-j\fP, \fB\-\-jobs\fP[=\fIAufträge\fP|\fBauto\fP]
226 Anzahl an Aufträgen, die simultan laufen dürfen, Anzahl von Aufträgen, die
227 zur Anzahl der verfügbaren Prozessoren passt, falls \fBauto\fP angegeben ist
228 (seit Dpkg 1.17.10) oder eine unbegrenzte Anzahl, falls \fIAufträge\fP nicht
229 angegeben ist, äquivalent zu der Option von \fBmake\fP(1) mit dem gleichen
230 Namen (seit Dpkg 1.14.7, lange Option seit Dpkg 1.18.8). Fügt sich selbst zu
231 der Umgebungsvariablen \fBMAKEFLAGS\fP hinzu, was dazu führen sollte, dass alle
232 folgenden Aufrufe von Make diese Option erben werden. Damit wird dem Paket
233 die Paralle\-Einstellung aufgezwungen (und möglicherweise dem Bausystem der
234 Originalautoren, falls dieses Make verwendet), unabhängig von deren
235 Unterstützung für paralleles Bauen. Dies kann zu Fehlern beim Bauen
236 führen. Fügt auch \fBparallel=\fP\fIAufträge\fP oder \fBparallel\fP zu der
237 Umgebungsvariablen \fBDEB_BUILD_OPTIONS\fP hinzu, was es debian/rules\-Dateien
238 erlaubt, diese Information für eigene Zwecke zu verwenden. Der Wert \fB\-j\fP
239 setzt die Option \fBparallel=\fP\fIAufträge\fP oder die Option \fBparallel\fP in der
240 Umgebungsvariable \fBDEB_BUILD_OPTIONS\fP außer Kraft. Beachten Sie, dass der
241 Wert \fBauto\fP durch die tatsächliche Anzahl der derzeitig aktiven Prozessoren
242 ersetzt wird und somit nicht an irgendeinen Kindprozess weitergegeben
243 wird. Falls die Anzahl der verfügbaren Prozessoren nicht ermittelt werden
244 kann, fällt der Code auf eine serielle Abarbeitung zurück (seit Dpkg
245 1.18.15). Dies sollte aber nur auf exotischen und nicht unterstützten
246 Systemen passieren.
247 .TP 
248 \fB\-J\fP, \fB\-\-jobs\-try\fP[=\fIAufträge\fP|\fBauto\fP]
249 Diese Option (seit Dpkg 1.18.2, lange Option seit Dpkg 1.18.8) ist
250 äquivalent zu der Option \fB\-j\fP, allerdings setzt sie die Umgebungsvariable
251 \fBMAKEFLAGS\fP nicht und ist daher sich sicherer mit allen Paketen zu
252 benutzen, auch denen, die nicht sicher parallel bauen.
253
254 \fBauto\fP ist das Standardverhalten (seit Dpkg 1.18.11). Durch Setzen der
255 Anzahl von Aufträgen auf 1 wird das serielle Verhalten wiederhergestellt.
256 .TP 
257 \fB\-D\fP, \fB\-\-check\-builddeps\fP
258 Prüfe Bauabhängigkeiten und \-konflikte; Abbruch falls diese nicht erfüllt
259 sind (lange Option seit Dpkg 1.18.8). Dies ist das Standardverhalten.
260 .TP 
261 \fB\-d\fP, \fB\-\-no\-check\-builddeps\fP
262 Überprüfe Bauabhängigkeiten und \-konflikte nicht (lange Option seit Dpkg
263 1.18.8).
264 .TP 
265 \fB\-\-ignore\-builtin\-builddeps\fP
266 Prüft die eingebauten Bauabhängigkeiten und \-konflikte nicht (seit Dpkg
267 1.18.2). Es gibt distributionsabhängige spezifische implizite
268 Abhängigkeiten, die normalerweise in der Bauumgebung benötigt werden, die
269 sogenannte »Build\-Essential«\-Paketgruppe.
270 .TP 
271 \fB\-nc\fP, \fB\-\-no\-pre\-clean\fP
272 Bereinige den Quellbaum nicht (lange Option seit Dpkg 1.18.8). Impliziert
273 \fB\-b\fP, falls ansonsten nichts aus \fB\-F\fP, \fB\-g\fP, \fB\-G\fP, \fB\-B\fP, \fB\-A\fP oder
274 \fB\-S\fP gewählt wurde. Impliziert \fB\-d\fP mit \fB\-S\fP (seit Dpkg 1.18.0).
275 .TP 
276 \fB\-\-pre\-clean\fP
277 Bereinige den Quellbaum vor dem Bau (seit Dpkg 1.18.8).
278 .TP 
279 \fB\-tc\fP, \fB\-\-post\-clean\fP
280 Den Quellbaum säubern (verwendet \fIroot\-werde\-Befehl\fP \fBdebian/rules clean\fP)
281 nachdem das Paket gebaut wurde (lange Option seit Dpkg 1.18.8).
282 .TP 
283 \fB\-r\fP, \fB\-\-root\-command=\fP\fIroot\-werde\-Befehl\fP
284 Wenn \fBdpkg\-buildpackage\fP einen Teil des Bauprozesses als Root ausführen
285 muss, stellt es dem auszführenden Befehl den \fIroot\-werde\-Befehl\fP voran,
286 falls dieser angegeben wurde (lange Option seit Dpkg 1.18.8). Andernfalls
287 wird standardmäßig \fBfakeroot\fP verwendet, falls es vorhanden ist. Der
288 \fIroot\-werde\-Befehl\fP sollte der Name des Programmes im \fBPATH\fP sein und wird
289 als Argumente den Namen des wirklich auszuführenden Befehles und dessen
290 Argumente erhalten. \fIroot\-werde\-Befehl\fP kann Parameter enthalten (die durch
291 Leerzeichen voneinander getrennt sein müssen), aber keine
292 Shell\-Metazeichen. Typischerweise ist der \fIroot\-werde\-Befehl\fP \fBfakeroot\fP,
293 \fBsudo\fP, \fBsuper\fP oder \fBreally\fP. \fBsu\fP ist nicht geeignet, da es nur die
294 Shell des Benutzers mit \fB\-c\fP aufrufen kann, anstatt Argumente individuell
295 zur Ausführung des Programms zu übergeben.
296 .TP 
297 \fB\-R\fP, \fB\-\-rules\-file=\fP\fIrules\-Datei\fP
298 Der Bau eines Debian\-Pakets erfolgt gewöhnlich durch Aufruf von
299 \fBdebian/rules\fP als ein Befehl mit mehreren Standardparametern (seit Dpkg
300 1.14.17, lange Option seit Dpkg 1.18.8). Mit dieser Option ist es möglich,
301 einen anderen Programmaufruf zum Bau des Paketes zu verwenden (es können
302 durch Leerzeichen getrennte Parameter angegeben werden). Alternativ kann die
303 Standard\-rules\-Datei mit einem anderen Make\-Programm ausgeführt werden (zum
304 Beispiel durch die Verwendung von \fB/usr/local/bin/make \-f debian/rules\fP als
305 \fIrules\-Datei\fP).
306 .TP 
307 \fB\-\-check\-command=\fP\fIPrüfbefehl\fP
308 Befehl, der zum Prüfen der \fB.changes\fP\-Datei selbst und sämtlichen in der
309 Datei referenzierten Artefakten verwandt wird (seit Dpkg 1.17.6). Der Befehl
310 sollte den Pfadnamen der \fB.changes\fP als Argument erhalten. Dieser Befehl
311 ist normalerweise \fBlintian\fP.
312 .TP 
313 \fB\-\-check\-option=\fP\fIOpt\fP
314 Option \fIOpt\fP an den \fIPrüfbefehl\fP, der mit \fBDEB_CHECK_COMMAND\fP oder
315 \fB\-\-check\-command\fP spezifiziert wurde, übergeben (seit Dpkg 1.17.6). Kann
316 mehrfach verwandt werden.
317 .TP 
318 \fB\-\-hook\-\fP\fIHook\-Name\fP\fB=\fP\fIHook\-Befehl\fP
319 Setzt den angegebenen Shell\-Code \fIHook\-Befehl\fP als den Hook \fIHook\-Name\fP,
320 der an den Zeitpunkten läuft, die in den Ablaufschritten angegeben sind
321 (seit Dpkg 1.17.6). Die Hooks werden immer ausgeführt, selbst falls die
322 folgende Aktion nicht durchgeführt wird (außer beim Hook \fBbinary\fP). Alle
323 Hooks werden in dem entpackten Quellverzeichnis ausgeführt.
324
325 Hinweis: Hooks können den Bauprozess beeinflussen und zu Baufehlern führen,
326 falls ihre Befehle fehlschlagen. Passen Sie daher auf ungeplante
327 Konsequenzen auf.
328
329 Die derzeit unterstützten \fIHook\-Name\fPn sind:
330
331 \fBinit preclean source build binary buildinfo changes postclean check sign
332 done\fP
333
334 Der \fIHook\-Befehl\fP unterstützt die folgende Ersetzungsformatzeichenkette,
335 die vor seiner Ausführung angewandt wird:
336
337 .RS
338 .TP 
339 \fB%%\fP
340 Ein einzelnes %\-Zeichen.
341 .TP 
342 \fB%a\fP
343 Ein logischer Wert (0 oder 1), der darstellt, ob die folgende Aktion
344 ausgeführt wird oder nicht.
345 .TP 
346 \fB%p\fP
347 Der Quellpaketname.
348 .TP 
349 \fB%v\fP
350 Die Quellpaket\-Version.
351 .TP 
352 \fB%s\fP
353 Die Quellpaket\-Version (ohne die Epoche).
354 .TP 
355 \fB%u\fP
356 Die Original\- (Upstream\-)Version.
357 .RE
358 .TP 
359 \fB\-\-buildinfo\-option=\fP\fIOpt\fP
360 Option \fIOpt\fP an \fBdpkg\-genbuildinfo\fP weitergeben (seit Dpkg 1.18.11). Kann
361 mehrfach verwandt werden.
362 .TP 
363 \fB\-p\fP, \fB\-\-sign\-command=\fP\fIUnterschreibbefehl\fP
364 Wenn \fBdpkg\-buildpackage\fP GPG zum Unterschreiben einer Quellsteuerdatei
365 (\fB.dsc\fP) oder einer \fB.changes\fP\-Datei benötigt, wird es statt \fBgpg\fP oder
366 \fBgpg2\fP den \fIUnterschreibbefehl\fP ausführen (und dabei falls notwendig den
367 \fBPATH\fP durchsuchen) (lange Option seit Dpkg 1.18.8). \fIUnterschreibbefehl\fP
368 wird alle Argumente erhalten, die \fBgpg\fP oder \fBgpg2\fP erhalten
369 hätte. \fIUnterschreibbefehl\fP sollte keine Leerzeichen oder andere
370 Metazeichen der Shell enthalten.
371 .TP 
372 \fB\-k\fP, \fB\-\-sign\-key=\fP\fISchlüsselkennung\fP
373 Geben Sie die Schlüsselkennung zur Signatur von Paketen an (lange Option
374 seit Dpkg 1.18.8).
375 .TP 
376 \fB\-us\fP, \fB\-\-unsigned\-source\fP
377 Das Quellpaket nicht unterschreiben (lange Option seit Dpkg 1.18.8).
378 .TP 
379 \fB\-ui\fP, \fB\-\-unsigned\-buildinfo\fP
380 Die \fB.buildinfo\fP\-Datei nicht unterschreiben (seit Dpkg 1.18.19).
381 .TP 
382 \fB\-uc\fP, \fB\-\-unsigned\-changes\fP
383 Die \fB.changes\fP\- und die \fB.buildinfo\fP Datei nicht unterschreiben (lange
384 Option seit Dpkg 1.18.8).
385 .TP 
386 \fB\-\-no\-sign\fP
387 Keine Datei unterschreiben, das schließt Quellpakete, die Datei
388 \&\fB.buildinfo\fP und die Datei \fB.changes\fP ein (seit Dpkg 1.18.20).
389 .TP 
390 \fB\-\-force\-sign\fP
391 Das Unterschreiben der entstehenden Dateien erzwingen (seit Dpkg 1.17.0),
392 unabhängig von \fB\-us\fP, \fB\-\-unsigned\-source\fP, \fB\-ui\fP,
393 \fB\-\-unsigned\-buildinfo\fP, \fB\-uc\fP, \fB\-\-unsigned\-changes\fP oder anderen internen
394 Heuristiken.
395 .TP 
396 \fB\-sn\fP
397 .TQ
398 \fB\-ss\fP
399 .TQ
400 \fB\-sA\fP
401 .TQ
402 \fB\-sk\fP
403 .TQ
404 \fB\-su\fP
405 .TQ
406 \fB\-sr\fP
407 .TQ
408 \fB\-sK\fP
409 .TQ
410 \fB\-sU\fP
411 .TQ
412 \fB\-sR\fP
413 .TQ
414 \fB\-i\fP, \fB\-\-diff\-ignore\fP[=\fIregex\fP]
415 .TQ
416 \fB\-I\fP, \fB\-\-tar\-ignore\fP[=\fIMuster\fP]
417 .TQ
418 \fB\-z\fP, \fB\-\-compression\-level=\fP\fIStufe\fP
419 .TQ
420 \fB\-Z\fP, \fB\-\-compression=\fP\fIKomprimierer\fP
421 Wird unverändert an \fBdpkg\-source\fP weitergegeben. Lesen Sie dessen
422 Handbuchseite.
423 .TP 
424 \fB\-\-source\-option=\fP\fIOpt\fP
425 Option \fIOpt\fP an \fBdpkg\-source\fP weitergeben (seit Dpkg 1.15.6). Kann
426 mehrfach verwandt werden.
427 .TP 
428 \fB\-\-changes\-option=\fP\fIOpt\fP
429 Option \fIOpt\fP an \fBdpkg\-genchanges\fP weitergeben (seit Dpkg 1.15.6). Kann
430 mehrfach verwandt werden.
431 .TP 
432 \fB\-\-admindir=\fP\fIVerz\fP
433 .TQ
434 \fB\-\-admindir \fP\fIVerz\fP
435 Ändert den Ablageort der \fBdpkg\fP\-Datenbank (seit Dpkg 1.14.0). Der
436 Standardort ist \fI%ADMINDIR%\fP.
437 .TP 
438 \fB\-?\fP, \fB\-\-help\fP
439 Zeige den Bedienungshinweis und beende.
440 .TP 
441 \fB\-\-version\fP
442 Gebe die Version aus und beende sich.
443 .
444 .SH UMGEBUNG
445 .SS "Externe Umgebung"
446 .TP 
447 \fBDEB_CHECK_COMMAND\fP
448 Falls gesetzt, wird er zum Prüfen der \fB.changes\fP\-Datei verwandt (seit Dpkg
449 1.17.6). Wird durch die Option \fB\-\-check\-command\fP außer Kraft gesetzt.
450 .TP 
451 \fBDEB_SIGN_KEYID\fP
452 Falls gesetzt, wird sie zum Unterschreiben der \fB.changes\fP\- und
453 \&\fB.dsc\fP\-Dateien verwandt (seit Dpkg 1.17.2). Wird durch die Option
454 \fB\-\-sign\-key\fP außer Kraft gesetzt.
455 .TP 
456 \fBDEB_BUILD_OPTIONS\fP
457 Falls gesetzt, wird es eine durch Leerraumzeichen getrennte Liste von
458 Optionen enthalten, die den Bauprozess in \fIdebian/rules\fP und das Verhalten
459 einiger Dpkg\-Befehle beeinflussen könnten.
460
461 Mit \fBnocheck\fP wird die Variable \fBDEB_CHECK_COMMAND\fP ignoriert. Mit
462 \fBparallel=\fP\fIN\fP werden die parallelen Aufträge auf \fIN\fP gesetzt, was durch
463 die Option \fB\-\-jobs\-try\fP außer Kraft gesetzt wird.
464 .TP 
465 \fBDEB_BUILD_PROFILES\fP
466 Falls gesetzt, wird sie als aktive(s) Bau\-Profil(e) für das zu bauende Paket
467 verwandt (seit Dpkg 1.17.2). Es ist eine durch Leerzeichen getrennte Liste
468 von Profilnamen. Wird durch die Option \fB\-P\fP außer Kraft gesetzt.
469 .TP 
470 \fBDPKG_COLORS\fP
471 Setzt den Farbmodus (seit Dpkg 1.18.5). Die derzeit unterstützten Werte
472 sind: \fBauto\fP (Vorgabe), \fBalways\fP und \fBnever\fP.
473
474 .SS "Interne Umgebung"
475 Selbst falls \fBdpkg\-buildpackage\fP einige Variablen exportiert, sollte
476 \fBdebian/rules\fP sich nicht auf ihre Gegenwart verlassen, sondern stattdessen
477 die entsprechende Schnittstelle verwenden, um die benötigten Werte
478 abzufragen, da diese Datei der Haupteintrittspunkt für den Bau von Paketen
479 ist und es möglich sein soll, sie unabhängig aufrufen zu können.
480
481 .TP 
482 \fBDEB_BUILD_*\fP
483 .TQ
484 \fBDEB_HOST_*\fP
485 .TQ
486 \fBDEB_TARGET_*\fP
487 Beim Aufruf von \fBdpkg\-architecture\fP werden die Parameter von \fB\-a\fP und
488 \fB\-t\fP durchgereicht. Jede Variable, die von seiner Option \fB\-s\fP ausgegeben
489 wird, wird in die Bauumgebung integriert.
490
491 .TP 
492 \fBSOURCE_DATE_EPOCH\fP
493 Diese Variable wird auf den Unix\-Zeitstempel seit der Epoche des letzten
494 Eintrags in \fIdebian/changelog\fP gesetzt, falls sie noch nicht definiert ist.
495 .
496 .SH DATEIEN
497 .TP 
498 \fI%PKGCONFDIR%/buildpackage.conf\fP
499 Systemweite Konfigurationsdatei
500 .TP 
501 \fI$XDG_CONFIG_HOME/dpkg/buildpackage.conf\fP oder
502 .TQ
503 \fI$HOME/.config/dpkg/buildpackage.conf\fP
504 Benutzer\-Konfigurationsdatei
505 .
506 .SH BEMERKUNGEN
507 .SS "Kompilierschalter werden nicht mehr exportiert"
508 Zwischen Dpkg 1.14.17 and 1.16.1 exportierte \fBdpkg\-buildpackage\fP
509 Kompilierschalter (\fBCFLAGS\fP, \fBCXXFLAGS\fP, \fBFFLAGS\fP, \fBCPPFLAGS\fP und
510 \fBLDFLAGS\fP) mit Werten, die von \fBdpkg\-buildflags\fP geliefert wurden. Dies
511 ist nicht mehr der Fall.
512 .SS "Standard Bauziele"
513 \fBdpkg\-buildpackage\fP verwendet seit Dpkg 1.16.2 die Ziele \fBbuild\-arch\fP und
514 \fBbuild\-indep\fP. Diese Ziele sind daher verpflichtend. Um aber Baufehler bei
515 existierenden Paketen zu vermeiden und um den Übergang zu erleichtern, (und
516 seit Dpkg 1.18.8 falls das Quellpaket nicht sowohl architekturabhängige wie
517 \-unabhängige Binärpakete baut) wird es auf das Ziel \fBbuild\fP zurückfallen,
518 falls \fBmake \-f debian/rules \-qn\fP \fIBauziel\fP den Rückgabewert 2 liefert.
519 .SH FEHLER
520 Es sollte möglich sein, Leerzeichen und Metazeichen der Shell und
521 Anfangsargumente für \fIroot\-werde\-Befehl\fP und \fIUnterschreibbefehl\fP
522 anzugeben.
523 .
524 .SH "SIEHE AUCH"
525 .ad l
526 \fBdpkg\-source\fP(1), \fBdpkg\-architecture\fP(1), \fBdpkg\-buildflags\fP(1),
527 \fBdpkg\-genbuildinfo\fP(1), \fBdpkg\-genchanges\fP(1), \fBfakeroot\fP(1),
528 \fBlintian\fP(1), \fBgpg2\fP(1), \fBgpg\fP(1).
529 .SH ÜBERSETZUNG
530 Die deutsche Übersetzung wurde 2004, 2006-2017 von Helge Kreutzmann
531 <debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
532 2008 von Sven Joachim <svenjoac@gmx.de>
533 angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
534 GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
535 Es gibt KEINE HAFTUNG.