Commit | Line | Data |
---|---|---|
1479465f GJ |
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. |